Skip to main content

Error schema

All error responses follow this structure:
{
  "error": "string",
  "message": "string (optional)"
}

Common status codes

  • 400: The request was invalid or malformed.
  • 401: Unauthorized – Missing or invalid authentication.
  • 403: Forbidden – You don’t have permission or feature access.
  • 404: Resource not found.
  • 429: Rate limit exceeded.
  • 500: Unexpected error while processing the request.

Examples

401 Unauthorized
{
  "error": "Unauthorized",
  "message": "Missing or invalid bearer token"
}
429 Too Many Requests
{
  "error": "Rate limit exceeded",
  "message": "You are limited to 100 requests per 5 minutes."
}