Overview
Products
Reference
Error codes
Errors are returned as JSON: {"error": {"code": "...", "message": "..."}}.
| Code | HTTP status | Meaning |
|---|---|---|
missing_api_key | 401 | No X-Api-Key header or api_key query param was provided. |
invalid_api_key | 401 | The API key provided does not match any active key. |
inactive_api_key | 403 | The API key exists but has been deactivated. |
rate_limit_exceeded | 429 | Too many requests this minute for your tier. |
daily_limit_exceeded | 429 | Your tier's daily allowance is used up; it resets at midnight UK time. |
not_found | 404 | The requested resource does not exist. |
method_not_allowed | 405 | The HTTP method is not supported for this route. |
date_out_of_range | 400 | Journey planning has no timetables for the datetime asked for. The message gives the first and last dates that can be planned, about two months ahead. |
outside_coverage | 422 | Journey planning doesn't cover that origin or destination (such as the Isle of Man), or they are in separate areas with no connection, such as Great Britain and Ireland. |
planner_unavailable | 503 | Journey planning didn't respond in time. Retry after the Retry-After seconds; other endpoints are unaffected. |
internal_error | 500 | An unexpected server error occurred. |