Skip to content

Errors

Every error is JSON with the same three fields:

{ "error": "invalid_key", "input": "X-Api-Key", "detail": "Send a live key in the X-Api-Key header." }
Status error What happened
400 invalid_request An input is missing or not in the expected form. input names it.
401 invalid_key No live key, and no rider’s token. The same answer whether the key is missing, unknown or deleted.
401 (none) A rider’s operation without a live token for the API. The WWW-Authenticate header says where to sign in.
404 not_found No such metro or ride. A draft ride answers the same as one that never existed.

A day outside the calendar’s reach is a 400 on day, so you can tell “nothing that day” from “we don’t know that far ahead”.