Skip to main content

Error Handling

The API uses standard HTTP status codes and returns JSON error responses.

Error Response Format

HTTP Status Codes

Common Error Codes

UNAUTHORIZED

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

INVALID_REQUEST

Solution: Check the request body includes all required fields.

NOT_FOUND

Solution: Verify the session ID exists and belongs to your account.

RATE_LIMITED

Solution: Reduce request frequency or contact us for higher limits.

Handling Errors in Code

Retry Strategy

For transient errors (5xx, rate limits), implement exponential backoff: