Errors

Understanding and handling API errors.

Error Response Format

All errors return JSON with an error field:

{
  "error": "Error message describing what went wrong"
}

Code	Meaning	Description
`200`	OK	Request successful
`400`	Bad Request	Invalid request parameters
`401`	Unauthorized	Invalid or missing API key
`403`	Forbidden	Authenticated but not authorized
`404`	Not Found	Resource doesn't exist
`429`	Too Many Requests	Rate limit exceeded
`500`	Internal Server Error	Server error

Status: 401 Unauthorized

{
  "error": "Unauthorized"
}

Solution: Check your API key is correct and included in the Authorization header.

Status: 404 Not Found

{
  "error": "Resource not found"
}

Solution: Verify the resource ID exists and you have access to it.

Status: 429 Too Many Requests

{
  "error": "Rate limit exceeded. Please try again later."
}

Solution: Wait 60 seconds before retrying. See Rate Limiting.

Status: 400 Bad Request

{
  "error": "Invalid parameters provided"
}

Solution: Check your request parameters match the API documentation.