Error Handling

Common error responses and status codes.

All error responses follow a consistent format:

{
  "statusCode": 400,
  "message": "Description of what went wrong",
  "error": "Bad Request"
}

Common status codes:

• 400 Bad Request — Invalid request body or parameters
• 401 Unauthorized — Missing or invalid API key
• 403 Forbidden — API key doesn't have access to this resource
• 404 Not Found — Resource doesn't exist or doesn't belong to you
• 429 Too Many Requests — Rate limit exceeded
• 500 Internal Server Error — Something went wrong on our end

For 429 errors, check the X-RateLimit-Reset header for when you can retry.

Reputation