Errors
Error responses, status codes, and how to handle them.
Errors use this shape:
{
"success": false,
"statusCode": 401,
"timestamp": "2026-11-05T10:15:30.000Z",
"path": "/v1/flights",
"method": "GET",
"error": "Unauthorized",
"message": [
"Invalid or inactive API key"
]
}Status codes
| Status | Meaning | What to do |
|---|---|---|
400 | Invalid query parameters | Check the parameter types and allowed values |
401 | Missing or invalid API key | Check the key and authentication header |
402 | No active subscription or no credits left | Upgrade or wait for your plan to renew |
404 | Flight not found | Check the flight ID |
429 | Rate limit exceeded | Wait for Retry-After seconds |
500 | Unexpected server error | Retry with backoff and contact support if it persists |
Retries
Retry 429 and 500 responses with exponential backoff. Do not retry 400,
401, 402, or 404 without changing the request.