Error codes

Errors are returned as JSON: {"error": {"code": "...", "message": "..."}}.

CodeHTTP statusMeaning
missing_api_key401No X-Api-Key header or api_key query param was provided.
invalid_api_key401The API key provided does not match any active key.
inactive_api_key403The API key exists but has been deactivated.
rate_limit_exceeded429Too many requests this minute for your tier.
daily_limit_exceeded429Your tier's daily allowance is used up; it resets at midnight UK time.
not_found404The requested resource does not exist.
method_not_allowed405The HTTP method is not supported for this route.
date_out_of_range400Journey 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_coverage422Journey 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_unavailable503Journey planning didn't respond in time. Retry after the Retry-After seconds; other endpoints are unaffected.
internal_error500An unexpected server error occurred.