1. [    Home ](/)
2. [Documentation](/docs)
3. [API Reference](/docs?category=31)
4. Error Codes Reference
 
 API Reference Latest      5 min read  

# Error Codes Reference

  A  admin  April 15, 2026  

 

 

 

 

 

 

  ## On this page

  
  [    Back to top ](#main-content) 

 ## Error Response Format

{  
 "error": {  
 "code": "string",  
 "message": "Human-readable description",  
 "trace\_id": "trc\_abc123",  
 "details": \[  
 {  
 "field": "amount",  
 "issue": "must be a positive integer"  
 }  
 \]  
 }  
}

## Authentication Errors (401 / 403)

CodeHTTPDescriptionResolutionTOKEN\_EXPIRED401Access token has expiredRequest a new access tokenTOKEN\_INVALID401Token signature does not matchCheck that you are using the correct signing keyTOKEN\_MISSING401No Authorization header providedAdd Authorization: Bearer {token}SCOPE\_INSUFFICIENT403Token lacks required scopeRe-authenticate with the required scopeIP\_NOT\_ALLOWED403Request originates from a blocked IPAdd your IP to the allowlist## Request Errors (400 / 422)

CodeHTTPDescriptionINVALID\_PARAMETER400A query parameter has an invalid valueMISSING\_REQUIRED\_FIELD400A required JSON field is absentVALIDATION\_FAILED422One or more fields failed validation rulesDUPLICATE\_IDEMPOTENCY\_KEY409This idempotency key was already used## Resource Errors (404 / 409)

CodeHTTPDescriptionRESOURCE\_NOT\_FOUND404The requested resource does not existACCOUNT\_CLOSED409Operation attempted on a closed accountINSUFFICIENT\_FUNDS409Account balance is too low## Rate Limit / Server Errors

CodeHTTPDescriptionRATE\_LIMIT\_EXCEEDED429Too many requests — check Retry-After headerINTERNAL\_SERVER\_ERROR500Unexpected error — retry with back-offSERVICE\_UNAVAILABLE503Temporary outage — retry later

 

 

 

 ### Tags

Tags

[Error Handling](/taxonomy/term/43)