API Documentation

GET

Get available promocodes

/promo/available

Deprecated

This method still works, but API v3 has a newer one.

Use the v3 method instead

Get available for activation promocodes.

This method requires authorization!

You can use your own API key, which can be obtained at control panel.

This method - requires permissions -promo.read

When creating an API token in your control panel, you can choose certain permissions (for example: prevent the token from placing orders).
You can also find a list of permissions in our documentation.

Query method

GEThttps://api.stableproxy.com/v2/promo/available

Code examples

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/promo/available", {
3  method: "GET",
4  headers: {
5    "Authorization": "API-Token [YOUR TOKEN]",
6    "Content-Type": "application/json"
7  }
8});
9const data = await response.json();

Examples of answers

Success response200 application/json

{
  "data": [
    {
      "id": "leave_review",
      "name": "Промо 'Залиш відгук'",
      "description": "Залиш відгук, і отримай 1$ при поповнення балансу!",
      "max": 1,
      "reward": {
        "reward": 1,
        "expires_at": "2023-12-20T13:09:52.127005Z",
        "data": {
          "type": "topup_plus_usd",
          "usages": {
            "global": 1
          }
        }
      },
      "active_promo_link": "http://api.stableproxy.com/dashboard/specials/leave-review",
      "is_available": true
    },
    {
      "id": "old_user",
      "name": "Промо 'Старий користувач'",
      "description": "Усі користувачі зареєстровані до 2023 року, отримають бонус 1$ за поповнення.",
      "max": 1,
      "reward": {
        "reward": 1,
        "expires_at": "2023-12-20T13:09:52.127050Z",
        "data": {
          "type": "topup_plus_usd",
          "usages": {
            "global": 1
          }
        }
      },
      "active_promo_link": "http://api.stableproxy.com/v2/promo/activate/eyJpdiI6InFFZVQxY015cjB3L0NVV1oyUUNxTlE9PSIsInZhbHVlIjoiWGhZKzlGRlByQlNRankzeXpGL1lISWZmWlYybWI1aWFQc2dYOW1OckN6djlqamRDOGIzTGR4UWFrSE0xcmtlVnhvdHZxZW1EQ1ZNaFhQTkxSR2d4SVdsNVFtTUxXM2NVZWFnbXR1L2VhcFE9IiwibWFjIjoiODgzOGFmNTc4M2I0ZjdkODZhYzZjN2Q4NmIzNTQ3NTdjYTE0N2VlMzUyNjZmMDVjZTZjOWUxMmI5OGViMDI4OCIsInRhZyI6IiJ9",
      "classes": "border-danger bg-light",
      "is_available": true
    }
  ],
  "good": true,
  "timestamp": 1700485792,
  "cause": {
    "type": "user",
    "user_id": 1,
    "token_id": 50,
    "token_sign": "397eb5db79e5cd4c591ada973f57379c"
  }
}

Promo

Query method

Code examples

Examples of answers