Error codes

This is the canonical numeric error-code list. For a narrative description of each family with recovery guidance, see Errors and codes.

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..."
  }
}

Errors and codes — narrative version with recovery steps
Troubleshooting
API overview

Getting started

Concepts

Qustody platform

Token management

Reference

Development

Code ranges

Response envelope

Getting started

Concepts

Qustody platform

Token management

Reference

Development

​Code ranges

​Response envelope

​Related

Code ranges

Response envelope

Related