Players export
Exports the end users (players) attributed to your affiliates as a GZIP-compressed CSV file, one row per player, with their registration, attribution and tracking details.
Request example
curl -X POST https://affiliatecontrol-api.com/external/exports/players \
-H "x-access-key: ak_example123" \
-H "x-secret-key: sk_example456" \
-H "Content-Type: application/json" \
-d '{
"site_id": ["site_abc"],
"created_at_from": "2026-06-01 00:00:00",
"created_at_to": "2026-06-30 23:59:59",
"updated_at_from": "2026-07-01 00:00:00",
"updated_at_to": "2026-07-31 23:59:59",
"webhook_url": "https://example.com/hook"
}'
Parameters:
site_id(Array of String): Limit to specific sites. Defaults to all of your sites.created_at_from/created_at_to(String, optional): Registration-date range,YYYY-MM-DD HH:mm:ss(UTC).updated_at_from/updated_at_to(String, optional): Last-update-date range,YYYY-MM-DD HH:mm:ss(UTC).webhook_url(String): URL notified when the file is ready.
Response:
Output fields
| # | Field | Type | Description |
|---|---|---|---|
| 1 | id |
string | Internal player ID. |
| 2 | site_id |
string | Site ID. |
| 3 | site_player_id |
string | Player ID. |
| 4 | first_name |
string | null | First Name. |
| 5 | last_name |
string | null | Last Name. |
| 6 | email |
string | null | Email. |
| 7 | phone_number |
string | null | Phone number. |
| 8 | is_virtual |
boolean | Whether the player is virtual. |
| 9 | player_country_code |
string | null | Player country code (ISO 3166-1 alpha-2). |
| 10 | affiliate_id |
string | Affiliate ID the player is attributed to. |
| 11 | affiliate_offer_id |
string | Offer ID the player is attributed to. |
| 12 | created_at |
string (datetime) | Registration date (UTC). |
| 13 | updated_at |
string (datetime) | Last update date of the player record (UTC). |
| 14 | last_active_at |
string (datetime) | null | Last activity timestamp. |
| 15 | btag |
string | null | Tracking BTAG. |
| 16 | tracking_url_short_id |
string | null | Short tracking-URL ID derived from the BTAG. |
| 17 | promo_code_id |
string | null | Promo code applied at registration. |
| 18 | marketing_material_id |
string | null | Marketing material the player came from. |
| 19 | external_id |
string | null | External ID. |
| 20 | subid1 |
string | null | SubID 1 tracking parameter. |
| 21 | subid2 |
string | null | SubID 2 tracking parameter. |
| 22 | subid3 |
string | null | SubID 3 tracking parameter. |
| 23 | subid4 |
string | null | SubID 4 tracking parameter. |
| 24 | subid5 |
string | null | SubID 5 tracking parameter. |
| 25 | subid6 |
string | null | SubID 6 tracking parameter. |
| 26 | subid7 |
string | null | SubID 7 tracking parameter. |
| 27 | subid8 |
string | null | SubID 8 tracking parameter. |
| 28 | subid9 |
string | null | SubID 9 tracking parameter. |
| 29 | subid10 |
string | null | SubID 10 tracking parameter. |
| 30 | is_restricted_promo |
boolean | Promo-restriction flag. |
| 31 | is_blocked |
boolean | Whether the player is blocked. |
| 32 | date_of_birth |
string (date) | null | Date of birth. |