Status

Useful for checking if the service and database is running. The JSON output also shows when the database was last updated.

Parameters

  • format=[text|json] (defaults to 'text')

Output

Text format

   https://nominatim.openstreetmap.org/status.php

will return HTTP status code 200 and print OK.

On error it will return HTTP status code 500 and print a message, e.g. ERROR: Database connection failed.

JSON format

   https://nominatim.openstreetmap.org/status.php?format=json

will return HTTP code 200 and a structure

  {
      "status": 0,
      "message": "OK",
      "data_updated": "2020-05-04T14:47:00+00:00",
      "software_version": "3.6.0-0",
      "database_version": "3.6.0-0"
  }

The software_version field contains the version of Nominatim used to serve the API. The database_version field contains the version of the data format in the database.

On error will also return HTTP status code 200 and a structure with error code and message, e.g.

   {
       "status": 700,
       "message": "Database connection failed"
   }

Possible status codes are

message notes
700 "No database" connection failed
701 "Module failed" database could not load nominatim.so
702 "Module call failed" nominatim.so loaded but calling a function failed
703 "Query failed" test query against a database table failed
704 "No value" test query worked but returned no results