docs/api/Status.md

   1 # Status
   2
   3 Useful for checking if the service and database is running. The JSON output also shows
   4 when the database was last updated.
   5
   6 ## Parameters
   7
   8 * `format=[text|json]` (defaults to 'text')
   9
  10
  11 ## Output
  12
  13 #### Text format
  14
  15 ```
  16    https://nominatim.openstreetmap.org/status.php
  17 ```
  18
  19 will return HTTP status code 200 and print `OK`.
  20
  21 On error it will return HTTP status code 500 and print a message, e.g.
  22 `ERROR: Database connection failed`.
  23
  24
  25
  26 #### JSON format
  27
  28 ```
  29    https://nominatim.openstreetmap.org/status.php?format=json
  30 ```
  31
  32 will return HTTP code 200 and a structure
  33
  34 ```json
  35   {
  36       "status": 0,
  37       "message": "OK",
  38       "data_updated": "2020-05-04T14:47:00+00:00"
  39   }
  40 ```
  41
  42 On error will also return HTTP status code 200 and a structure with error
  43 code and message, e.g.
  44
  45 ```json
  46    {
  47        "status": 700,
  48        "message": "Database connection failed"
  49    }
  50 ```
  51
  52 Possible status codes are
  53
  54    |     | message              | notes                                             |
  55    |-----|----------------------|---------------------------------------------------|
  56    | 700 | "No database"        | connection failed                                 |
  57    | 701 | "Module failed"      | database could not load nominatim.so              |
  58    | 702 | "Module call failed" | nominatim.so loaded but calling a function failed |
  59    | 703 | "Query failed"       | test query against a database table failed        |
  60    | 704 | "No value"           | test query worked but returned no results         |