Redemptions of the promo codes linked to a code, per day
API v2 - coming soon.
Coming soon
Needs your v2 key
401 legacy_key. How to get a v2 keyHow 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.
partnerKeyx-apikey<token>Your API v2 key (cgw2_...)
code*stringThe affiliate code (letter case ignored)
1 <= length <= 191from?stringSeries start (ISO 8601, UTC), default 30 days before to
date-timeto?stringSeries end (ISO 8601, UTC), default now. At most 366 days after from
date-timeOK
application/json- response
from*stringSeries start (ISO 8601, UTC)
date-timeto*stringSeries end (ISO 8601, UTC)
date-timepromos*array<>curl "https://api.csgowin.com/api/v2/affiliates/YOUR_CODE/promos/usage" \ -H "x-apikey: YOUR_V2_KEY"{ "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
| Status | When | Body |
|---|---|---|
| 400 | bad_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"}} |
| 401 | missing_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"}} |
| 403 | key_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"}} |
| 404 | not_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"}} |
| 429 | rate_limited: past a rate limit - wait the Retry-After seconds. | {"error":{"code":"rate_limited","message":"too many requests, please try again later."}} |
| 503 | unavailable: 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."}} |
The promo codes linked to a code GET
The promo codes support linked to the code, the newest first: how often each was redeemed, its cap and its expiry. 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.
The giveaways a creator hosts GET
The giveaways the code's owner hosts, live (open or being drawn, ending soonest first) or ended (drawn or cancelled, the latest first): the prize, when entries close, the entries, the requirements and, once drawn, the winners, as the site shows them to everyone. The same answer for every caller, so a stream overlay may poll it from any origin without a key. It is cached for 5 seconds and secondsLeft is counted from serverTime. A code whose owner hides their account answers 404, as the site names a hidden account as the host of nothing. 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).