Error codes
Format
The API returns errors in two ways:
- HTTP status + JSON with an
errorfield — authorization and system errors. - The
errorfield inside a 200 response — method-level errors (e.g. VIN not found). An emptyerrorstring means success.
HTTP statuses
| Status | Body | Reason | What to do |
|---|---|---|---|
| 200 | {"...": "...", "error": ""} | Success | — |
| 200 | {"...": "...", "error": "text"} | Method-level error (data not found, etc.) | Check the request parameters |
| 401 | {"error": "invalid api key"} | Key missing, not found, or blocked | Check api_key in the dashboard |
| 403 | {"error": "Client disabled. not enough money"} | Out of units or the package expired | Top up the balance in the dashboard |
| 404 | {"error": "error"} | Unknown method / path | Check the method URL |
| 5xx | — | Internal service error | Retry later; contact support if it persists |
Billing of failed requests
Requests that end with an error (any status other than 200) are not billed — units are deducted only for successful responses. See Pricing and billing.