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

# Error codes

> Complete numeric error-code catalog for the Qustody API.

This is the canonical numeric error-code list. For a narrative description of each family with recovery guidance, see [Errors and codes](/qustody/errors).

| Code | Type                                  | HTTP | Family      |
| ---: | ------------------------------------- | :--: | ----------- |
| 1000 | `UNAUTHORIZED`                        |  401 | Auth        |
| 1001 | `FORBIDDEN`                           |  403 | Auth        |
| 1002 | `API_KEY_REVOKED`                     |  401 | Auth        |
| 1003 | `INVALID_SIGNATURE`                   |  401 | Auth        |
| 1100 | `VALIDATION`                          |  400 | Validation  |
| 1101 | `MISSING_FIELD`                       |  400 | Validation  |
| 1102 | `INVALID_ADDRESS`                     |  400 | Validation  |
| 1103 | `INVALID_AMOUNT`                      |  400 | Validation  |
| 1104 | `DUPLICATE_EXTERNAL_ID`               |  409 | Validation  |
| 1105 | `OWNERSHIP_PROOF`                     |  400 | Validation  |
| 1106 | `INVALID_EMAIL`                       |  400 | Validation  |
| 1107 | `INVALID_URL`                         |  400 | Validation  |
| 1108 | `INVALID_PAGINATION`                  |  400 | Validation  |
| 1109 | `AMOUNT_OVERFLOW`                     |  400 | Validation  |
| 1110 | `STRING_TOO_LONG`                     |  400 | Validation  |
| 1200 | `POLICY_DENIED`                       |  422 | Policy      |
| 1201 | `APPROVAL_REQUIRED`                   |  422 | Policy      |
| 1202 | `APPROVAL_NOT_FOUND`                  |  404 | Policy      |
| 1300 | `TX_NOT_FOUND`                        |  404 | Transaction |
| 1301 | `TX_INVALID_STATE`                    |  409 | Transaction |
| 1302 | `TX_SIGNATURE_MISMATCH`               |  422 | Transaction |
| 1303 | `TX_BROADCAST_FAILED`                 |  502 | Transaction |
| 1304 | `TX_NONCE_TOO_LOW`                    |  422 | Transaction |
| 1400 | `VAULT_NOT_FOUND`                     |  404 | Vault       |
| 1401 | `VAULT_DUPLICATE`                     |  409 | Vault       |
| 1500 | `NODE_UNAVAILABLE`                    |  503 | Chain       |
| 1501 | `CHAIN_ERROR`                         |  502 | Chain       |
| 1600 | `INTERNAL_ERROR`                      |  500 | Server      |
| 1601 | `IDEMPOTENCY_CONFLICT`                |  422 | Server      |
| 1602 | `RATE_LIMITED`                        |  429 | Server      |
| 1700 | `TOKEN_STANDARD_NOT_SUPPORTED`        |  400 | Token       |
| 1701 | `TOKEN_TEMPLATE_NOT_FOUND`            |  404 | Token       |
| 1702 | `TOKEN_ALREADY_DEPLOYED`              |  409 | Token       |
| 1703 | `TOKEN_NOT_DEPLOYED`                  |  409 | Token       |
| 1704 | `TOKEN_OPERATION_NOT_ALLOWED`         |  422 | Token       |
| 1705 | `TOKEN_SUPPLY_EXCEEDED`               |  422 | Token       |
| 1706 | `TOKEN_MINT_NOT_ALLOWED`              |  403 | Token       |
| 1707 | `TOKEN_BURN_NOT_ALLOWED`              |  403 | Token       |
| 1708 | `TOKEN_ROLE_REQUIRED`                 |  403 | Token       |
| 1709 | `TOKEN_POLICY_REJECTED`               |  422 | Token       |
| 1710 | `TOKEN_APPROVAL_REQUIRED`             |  422 | Token       |
| 1711 | `TOKEN_CONTRACT_CALL_FAILED`          |  502 | Token       |
| 1712 | `TOKEN_INVALID_RECIPIENT`             |  400 | Token       |
| 1713 | `TOKEN_INVALID_AMOUNT`                |  400 | Token       |
| 1714 | `TOKEN_COMPLIANCE_RESTRICTION_FAILED` |  422 | Token       |
| 1715 | `TOKEN_OPERATION_ALREADY_PROCESSED`   |  409 | Token       |
| 1716 | `TOKEN_DEPLOYMENT_FAILED`             |  502 | Token       |

## Code ranges

| Range       | Family                           |
| ----------- | -------------------------------- |
| `1000–1099` | Authentication and authorization |
| `1100–1199` | Validation                       |
| `1200–1299` | Policy and approval              |
| `1300–1399` | Transaction lifecycle            |
| `1400–1499` | Vault and resource               |
| `1500–1599` | Upstream node and chain          |
| `1600–1699` | Server / infrastructure          |
| `1700–1749` | Token management                 |

## Response envelope

```json theme={null}
{
  "error": {
    "code": 1300,
    "type": "TX_NOT_FOUND",
    "message": "transaction not found",
    "request_id": "req_01HXYZ..."
  }
}
```

## Related

* [Errors and codes](/qustody/errors) — narrative version with recovery steps
* [Troubleshooting](/qustody/troubleshooting)
* [API overview](/qustody/api-overview)