Response codes - VA Docs

The HTTP status code is always 200. Check status.code in the response for the result. When you contact us, include the status.traceCode from the response so we can trace the request.

Common codes

Any API may return these codes:

Code	Description	What to do
`0`	Success	—
`101`	Request configuration error, such as an unknown path, a wrong HTTP method, a `Content-Type` other than `multipart/form-data`, or an invalid `Authorization`	Check the URL, method and headers. See Requests and responses.
`102`	Invalid signature	Go through the troubleshooting list in Signature.
`104`	Under maintenance	Call again after the maintenance ends.
`105`	The source IP is not allowlisted	Send us the IPs of the servers that call the API.
`201`	Bad parameters, such as a missing required parameter or a wrong format	Fix the parameters as described in `status.message`.
`999`	System error	Contact us with the `status.traceCode`.

API-specific codes

Only some APIs return these codes. Each API page lists the codes it may return under Response codes.

Code	Description	What to do
`103`	Request failed on our side	Retry later. If it keeps happening, contact us with the `status.traceCode`.
`106`	Request timed out	Contact us with the `status.traceCode` to confirm the result.
`202`	Account already exists in the same channel	Use another account, or keep using the existing one.
`203`	Duplicate transaction ID	Use a unique `transactionID` for every transaction.
`204`	Insufficient balance	Check the member’s wallet balance first.
`205`	Account does not exist	Create the member first, and check `channelID` and `account` (accounts are case-sensitive).
`206`	Game does not exist	Check the game ID with Get game list.
`207`	Wallet processing error	Check `status.message`. If it keeps happening, contact us with the `status.traceCode`.
`429`	Too many requests (only APIs with call limits return this)	Call less often and retry. See each API for its limit.
`602`	Bet not found	Check the bet ID and query conditions.
`800`	Risk control error; the member account may be locked	Contact our support team with the `status.traceCode`.

Free spin codes

Code	Description	What to do
`416`	Event not found, or the event is cancelled, not started or expired	Check the event with Get free spin event list.
`417`	The event has reached its member limit	—
`418`	The member is not in the event	Check that the member is bound to the event.
`419`	Duplicate event ID	—