Error Codes

Understanding API error responses

Error Response Format

All error responses follow this format:

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

Error Codes

400Bad Request

The request parameters are invalid or malformed.

Solution: Check your request body and ensure all required fields are present with valid values.

401Unauthorized

Invalid or missing API key.

Solution: Ensure you're including a valid API key in the Authorization header.

402Payment Required

Not enough credits in your API wallet.

Solution: Purchase more credits or wait for your credits to refill.

403Forbidden

API access not approved or your account is suspended.

Solution: Contact support if you believe this is an error.

404Not Found

The requested resource (task, webhook, etc.) was not found.

Solution: Verify the resource ID is correct.

429Too Many Requests

Too many requests in a short period.

Solution: Implement exponential backoff and respect rate limits.

500Internal Server Error

Something went wrong on our end.

Solution: Retry the request after a short delay. If the issue persists, contact support.

Rate Limits

Default rate limits: