Error Codes

This page lists all error status codes used across the API.

Security Errors

Status	Description
`INVALID_SIGNATURE`	Request signature validation failed. Check your signing implementation.

Status	Description
`EXTERNAL_SERVICE_TIMEOUT_ERROR`	Request to external service timed out. Retry the request.

Errors returned by our endpoints.

Status	HTTP Code	Description
`UNKNOWN_OPERATOR`	404	No operator exists for the provided `operatorId`

Status	HTTP Code	Description
`VALIDATION_ERROR`	400	Invalid request (missing required fields, invalid format)
`FREEBETS_NOT_ENABLED`	400	Freebets feature not enabled for your operator. Contact us to enable.
`PLAYER_NOT_FOUND`	404	Player with the provided `clientPlayerId` does not exist
`REWARD_ALREADY_EXISTS`	409	A reward with this `clientRewardId` already exists
`UNKNOWN_ERROR`	500	Internal server error

Errors you should return from your endpoints.

Status	HTTP Code	Description
`INSUFFICIENT_BALANCE_ERROR`	200	Player does not have enough balance for this bet
`DUPLICATE_TRANSACTION_ERROR`	200	Transaction ID already exists with a different payload
`BONUS_ERROR`	200	Bet does not pass bonus rules
`BET_LIMIT_REACHED_ERROR`	200	Player has reached their betting limit
`UNKNOWN_ERROR`	200	Bet could not be registered

These internal errors may occur when a player attempts to use a freebet. They are handled by 155.io and the player will see an appropriate message.

Code	Error	Description
16010	`FREEBET_INSUFFICIENT_AMOUNT`	Freebet amount is less than the minimum bet requirement
16011	`FREEBET_NOT_APPLICABLE_FOR_GAME`	Freebet is restricted to specific games and cannot be used on this game
16012	`FREEBET_CURRENCY_MISMATCH`	Freebet currency does not match the game/bet currency
16013	`FREEBETS_NOT_ENABLED`	Freebets are not enabled for this operator

Status	HTTP Code	Description
`DUPLICATE_TRANSACTION_ERROR`	200	Transaction ID already exists with a different payload
`UNKNOWN_ERROR`	200	Rollback could not be processed

Status	HTTP Code	Description
`DUPLICATE_TRANSACTION_ERROR`	200	Transaction ID already exists with a different payload
`UNKNOWN_ERROR`	200	Win could not be registered

All error responses should include the status field and echo back the requestId and clientPlayerId:

{
  "status": "ERROR_CODE_HERE",
  "requestId": "original-request-id",
  "clientPlayerId": "player-id"
}

All responses must be signed with the X-Marbles-Signature header, including error responses.