Skip to main content

​
HTTP Status Codes

​
Client Error Codes (4xx)

CodeNameDescriptionCommon Causes
400Bad RequestMalformed request syntax or invalid request parameters.Invalid JSON, missing required parameters, malformed data
401UnauthorizedAuthentication required. API key missing, invalid, or revoked.Missing Authorization header, invalid API key, revoked key
403ForbiddenAuthentication succeeded, but insufficient permissions for this resource.API key lacks permissions, accessing another org’s resources
404Not FoundRequested resource does not exist or was not found.Invalid resource ID, resource deleted, typo in URL
405Method Not AllowedHTTP method not supported for this endpoint (e.g., POST on a GET-only route).Using wrong HTTP method (POST instead of GET)
409ConflictRequest conflicts with current resource state (e.g., duplicate record).Duplicate resource, race condition, resource locked
422Unprocessable EntityRequest syntax valid, but semantic errors in data (validation failures).Missing required fields, invalid data types, values out of range
429Too Many RequestsRate limit exceeded. Wait before making additional requests.Too many requests in short period, see Rate Limits

​
Server Error Codes (5xx)

CodeNameDescriptionWhat To Do
500Internal Server ErrorUnexpected error on the server. Contact support if issue persists.Retry with exponential backoff
502Bad GatewayInvalid response from upstream server. Usually temporary.Retry after brief delay
503Service UnavailableServer temporarily unavailable (maintenance or overload).Retry after delay, check status page
504Gateway TimeoutRequest timed out waiting for upstream server.Retry with exponential backoff

​
Validation Errors

When a request fails validation (422 status), the response includes an errors object with field-specific messages: 
{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required.", "The email must be a valid email address."],
    "amount": ["The amount must be greater than 0."]
  }
}