| 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
{
"error": {
"code": 1300,
"type": "TX_NOT_FOUND",
"message": "transaction not found",
"request_id": "req_01HXYZ..."
}
}
Related
- Errors and codes — narrative version with recovery steps
- Troubleshooting
- API overview