Copy page

API

Errors

Understanding and handling API errors.

Error Response Format

All errors return JSON with an error field:

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

HTTP Status Codes

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

Common Errors

Invalid API Key

Status: 401 Unauthorized

Code
{
  "error": "Unauthorized"
}

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

Resource Not Found

Status: 404 Not Found

Code
{
  "error": "Resource not found"
}

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

Rate Limit Exceeded

Status: 429 Too Many Requests

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

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

Invalid Parameters

Status: 400 Bad Request

Code
{
  "error": "Invalid parameters provided"
}

Solution: Check your request parameters match the API documentation.

Next Steps

• Authentication - API key setup
• Rate Limiting - Usage limits