Errors API

Error Response Format

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_required_field",
    "message": "The field 'legal_name' is required.",
    "param": "legal_name",
    "request_id": "req_01HXK5V2N8PQRS3T4UV5WX6Y"
  }
}

HTTP Status Codes

Code	Meaning
200	Success
201	Created
202	Accepted
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
409	Conflict
422	Validation failed
429	Rate limited
500	Internal server error
503	Service unavailable

Rate Limit Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1709913060
Retry-After: 30