> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Response codes

> All possible values of status.code, what they mean and what to do.

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](https://doc.va777.net/en/v2/guides/request-format.md). |
| `102` | Invalid signature | Go through the troubleshooting list in [Signature](https://doc.va777.net/en/v2/guides/signature.md). |
| `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](https://doc.va777.net/en/v2/api-reference/member/create.md) first, and check `channelID` and `account` (accounts are case-sensitive). |
| `206` | Game does not exist | Check the game ID with [Get game list](https://doc.va777.net/en/v2/api-reference/game/list.md). |
| `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](https://doc.va777.net/en/v2/api-reference/freespin/event-list.md). |
| `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 | — |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.