Skip to main content

Error Response Format

All errors return a consistent JSON structure:
request_id is a top-level field alongside error, and is present on every error response. Include it when contacting support.

HTTP Status Codes

Error Types

Common Errors

Authentication Failed

Solution: Check your HMAC signature calculation.

Validation Error

Solution: Include all required fields in your request.

Rate Limited

Solution: Implement exponential backoff and retry logic.

Error Handling Best Practices