Skip to Content
CSGOWINAPI
API v2 Coming soonAffiliates

Redemptions of the promo codes linked to a code, per day

API v2 - coming soon.

Coming soon

API v2 is not open yet - every request to it answers 404 until it launches, and the details on this page may still change. Build on API v1 today - it keeps working. New keys and a one-step switch will arrive with v2.

Needs your v2 key

Your API v2 key is all this read needs, for any code you own - nothing has to be switched on per code. A v1 key answers 401 legacy_key. How to get a v2 key
GET
/api/v2/affiliates/{code}/promos/usage

How often each promo code support linked to the code was redeemed per UTC day over a window (at most 366 days, default the last 30), every day present: which campaign worked when.

Rate limits: 60 reads a minute per IP across /api/v2 and at most 25 to one path in 2 seconds (429 with Retry-After), and 60 a minute per account across its keyed reads.

Authorization

partnerKey
headerx-apikey<token>

Your API v2 key (cgw2_...)

Path Parameters

code*string

The affiliate code (letter case ignored)

Length1 <= length <= 191

Query Parameters

from?string

Series start (ISO 8601, UTC), default 30 days before to

Formatdate-time
to?string

Series end (ISO 8601, UTC), default now. At most 366 days after from

Formatdate-time

Response Body

OK

application/json
  1. response
from*string

Series start (ISO 8601, UTC)

Formatdate-time
to*string

Series end (ISO 8601, UTC)

Formatdate-time
promos*array<>
Example Request
curl "https://api.csgowin.com/api/v2/affiliates/YOUR_CODE/promos/usage" \  -H "x-apikey: YOUR_V2_KEY"
Example Response
{  "from": "2026-09-01T00:00:00.000Z",  "to": "2026-09-02T23:59:59.000Z",  "promos": [    {      "code": "EXAMPLE-PROMO",      "uses": 3,      "series": [        {          "day": "2026-09-01",          "uses": 2        },        {          "day": "2026-09-02",          "uses": 1        }      ]    }  ]}

Errors

StatusWhenBody
400bad_request: an input outside its rules, a cookie sent, or a refusal by the site (the message says which).{"error":{"code":"bad_request","message":"code: Too big: expected string to have <=191 characters"}}
401missing_key: no key in the x-apikey header. legacy_key: a v1 key - switch to API v2 for a v2 key. invalid_key: not a live API v2 key, or the code is not one of its account’s codes.{"error":{"code":"missing_key","message":"send your API v2 key in the x-apikey header"}}{"error":{"code":"legacy_key","message":"this is a v1 key: switch to API v2 in Profile > Affiliates > API key to get a v2 key"}}{"error":{"code":"invalid_key","message":"the key is not a live API v2 key of this code"}}
403key_blocked: API v2 is blocked for the account - contact support (a new key does not lift it). account_restricted: the account is restricted - contact support.{"error":{"code":"key_blocked","message":"this key is blocked: contact support"}}{"error":{"code":"account_restricted","message":"this account is restricted: contact support"}}
404not_found: no such giveaway, case or period, or the code has no board or giveaways (also every request while API v2 is not open, and every action while actions are not open).{"error":{"code":"not_found","message":"not found"}}
429rate_limited: past a rate limit - wait the Retry-After seconds.{"error":{"code":"rate_limited","message":"too many requests, please try again later."}}
503unavailable: not available for a moment and nothing was done - try again after the Retry-After seconds.{"error":{"code":"unavailable","message":"temporarily unavailable, please try again shortly."}}