Status service API reference
By default the /status endpoint will return a HTTP status code of 200 with version and tileset_last_modified (as UNIX timestamp) info, which can also be used as a health endpoint for the HTTP API.
However, if "verbose": true is passed as a request parameter it will return additional information about the loaded tileset. Note that gathering this additional information can be computationally expensive, hence the verbose flag can be disallowed in the configuration JSON (service_limits.status.allow_verbose, default false).
Outputs of the Status service
If "verbose": true is passed as a parameter, the service will output the following response:
| Response key | Type | Description |
|---|---|---|
version | string | The current Valhalla version, e.g. 3.1.4. |
tileset_last_modified | integer | The time the tile_extract or tile_dir were last modified as UNIX timestamp, e.g. 1634903519. |
has_tiles | bool | Whether a valid tileset is currently loaded. |
has_admins | bool | Whether the current tileset was built using the admin database. |
has_timezones | bool | Whether the current tileset was built using the timezone database. |
has_live_traffic | bool | Whether live traffic tiles are currently available. |
bbox | object | GeoJSON of the tileset extent. |
warnings (optional) | array | This array may contain warning objects informing about deprecated request parameters, clamped values etc. |
Last updated on