Skip to main content
Get Balance
curl --request GET \
  --url https://ss.game-services.work/balance \
  --header 'Authorization: Bearer <token>'
GET /balance?playerId=123e4567-e89b-12d3-a456-426614174000
&sessionId=abc123-session-id&promotionExternalId=promo-session-123&currency=USD&gameUuid=game-uuid-456

Documentation Index

Fetch the complete documentation index at: https://docs.game-services.work/llms.txt

Use this file to discover all available pages before exploring further.

GET /balance

​
Headers

NameTypeDescription
X-Auth-TokenstringCustom authentication header in the format X-Auth-Token: your_token_here. This token is required to authorize API requests.

​
Request Parameters

NameTypeDescription
playerIdstringUnique identifier of the player whose balance is being retrieved.
gameUuidstringUnique identifier of the game for which the request is being made.
sessionIdstringUnique identifier of the player’s session.
promotionExternalIdstringExternal identifier of the promotion session. This parameter must be sent for promo or free bet requests and omitted for regular game requests.
currencystringThe currency code for the transaction, typically in ISO 4217 format.

​
Response Parameters

NameTypeDescription
balancedecimalThe current balance of the player.

​
Error

If an error occurs while processing a request, the API must return a response with HTTP Status Code: 400 Bad Request
NameTypeDescription
error_codestringError code describing the specific issue.
Responsibility of the wallet platform
Assert that the incoming sessionId is valid, and return the player’s current balance. If promotionExternalId is present, resolve the balance in the context of the promo or free bet session identified by this value. 
GET /balance?playerId=123e4567-e89b-12d3-a456-426614174000
&sessionId=abc123-session-id&promotionExternalId=promo-session-123&currency=USD&gameUuid=game-uuid-456