Error Reference Directory

API Error Codes & Resolution Guide

Diagnose HTTP status errors, understand machine-readable error codes, and follow resolution steps.

HTTP 400 bad_request

400 Bad Request

The request payload is malformed or missing required parameter fields.

Common Cause:
Invalid JSON structure or missing "message" parameter.
How to Fix:
Ensure valid JSON syntax and verify required request parameters against API documentation.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "bad_request",
        "message": "The message field is required."
    }
}
HTTP 401 unauthorized

401 Unauthorized

The provided API key is invalid, expired, or missing from request headers.

Common Cause:
Header "x-api-key" missing or contains an inactive key string.
How to Fix:
Check header name "x-api-key" and verify key status in User Dashboard.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "unauthorized",
        "message": "Invalid or missing API key."
    }
}
HTTP 402 insufficient_credits

402 Payment Required

Account credit balance is insufficient to fulfill this API operation.

Common Cause:
Your account balance has reached 0 credits.
How to Fix:
Purchase additional credits or enable auto-recharge in Pricing & Billing.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "insufficient_credits",
        "message": "Credit balance depleted. Please top up your account."
    }
}
HTTP 404 not_found

404 Endpoint Not Found

Target API endpoint or resource slug does not exist.

Common Cause:
Typo in URL path string.
How to Fix:
Verify endpoint URI pattern in API Explorer.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "not_found",
        "message": "The requested endpoint does not exist."
    }
}
HTTP 422 validation_error

422 Unprocessable Content

Request payload failed schema validation rules.

Common Cause:
Field type mismatch or out-of-range value.
How to Fix:
Correct parameter data types and format fields as specified in API docs.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "validation_error",
        "message": "The source_lang parameter must be a 2-letter ISO code."
    }
}
HTTP 429 rate_limit_exceeded

429 Too Many Requests

Rate limit exceeded for current API key or IP address.

Common Cause:
Too many requests sent within 60 seconds.
How to Fix:
Implement exponential backoff or contact support to request higher rate limit tier.
Sample Error Response:
{
    "success": false,
    "error": {
        "code": "rate_limit_exceeded",
        "message": "Rate limit exceeded. Try again in 12 seconds."
    }
}