Active promotion claim

Live

GET/api/v1/promotions/active-claim

The promotion the member is currently on whose turnover is not yet met (status PENDING).

A member can hold only one active claim at a time. While on a promotion with the turnover not yet met, withdrawals are rejected (2009) and claiming another promotion returns 6006.

Headers

Field	Type	Required	Description
Authorization	string	Yes	Used — send Bearer <member access_token>
X-Api-Key	string	Yes	Agent API key (ak_…) from the bo screen
X-Timestamp	string	Yes	Signing time in unix milliseconds (±300s skew allowed)
X-Nonce	string	Yes	Unique per-request value (UUIDv4) for replay protection
X-Signature	string	Yes	hex(HMAC-SHA256(secret, canonical)) — see the Authentication page
X-Player-IP	string	—	The player's real IP (IPv4/IPv6) — recommended (used in login history)
X-Player-UA	string	—	The player's User-Agent (optional — recorded in login history)
X-Request-Id	string	—	Your correlation id — echoed back as request_uuid (recommended)
x-lang	string	—	th (default) or en — the language of message

Response

Fields in data

Field	Type	Required	Description
claim_id	string	—	Claim id
promotion_name	string	—	Promotion name at grant time (snapshot)
promotion_type	string	—	Promotion type of this bonusNEW_REGISTER \| FIRST_DEPOSIT \| CASHBACK \| FREE_CREDIT \| DAILY_LOGIN \| GOLDEN_MINUTE \| REFER_A_FRIEND \| COUPON_CODE
bonus_thb	string	—	Bonus amount granted (THB)
wager_required_thb	string \| null	—	Turnover required before withdrawing — null = this bonus has no wagering requirement.
wager_completed_thb	string	—	Turnover completed so far (updated in processing batches, not real-time)
withdraw_cap_thb	string \| null	—	Withdrawal cap of this bonus — null = uncapped
granted_at	string (ISO 8601)	—	When the bonus was granted
expires_at	string (ISO 8601) \| null	—	Turnover deadline — past this the bonus is forfeited; null = no expiry.

Response example

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "claim_id": "9d4c1f2a-6b8e-4d05-93a7-c51e0f8b2d46",
    "promotion_name": "เครดิตฟรี 50 บาท",
    "promotion_type": "FREE_CREDIT",
    "bonus_thb": "50.00",
    "wager_required_thb": "250.00",
    "wager_completed_thb": "120.00",
    "withdraw_cap_thb": "500.00",
    "granted_at": "2026-07-05T04:12:30.000Z",
    "expires_at": "2026-07-06T04:12:30.000Z"
  },
  "request_uuid": "b2e9a7d4-3c60-4f18-95ab-7d1c4e8f0a52"
}

Possible error codes

code	Name	HTTP	Message
1001	UNAUTHORIZED	401	Unauthorized
1007	TOKEN_INVALID	401	Token invalid