Errors

The API uses standard HTTP status codes and returns a consistent JSON error format so you can handle failures programmatically.

Error response format

Error response

{
  "success": false,
  "error": "Resource not found",
  "errors": ["Product with ID abc-123 does not exist"]
}
  • Name
    success
    Type
    boolean
    Description
    Always false for error responses.
  • Name
    error
    Type
    string
    Description
    Human-readable error summary.
  • Name
    errors
    Type
    string[]
    Description
    Detailed error messages. May contain multiple entries for validation errors.

Status codes

Code Description
200Request succeeded.
201Resource created successfully.
401Missing or invalid API key.
403Valid key, but insufficient permissions for this action.
404Resource not found.
422Validation failed. Check the errors array for details.
429Rate limit exceeded. Back off and retry.
500Internal server error. Contact support if persistent.

Rate limiting

Requests are rate-limited per API key. When you exceed the limit, the API returns 429 Too Many Requests. Use exponential backoff to retry.