Get geoip databases statistics

GET /_node/stats/geoip_download_manager
Basic auth

Get license checks and download status of Geoip filter plugin.

Query parameters

  • pretty boolean

    If you append ?pretty=true to the request, the JSON returned will be pretty formatted. Use it for debugging only!

Responses

  • 200 application/json

    A JSON object containing geoip database license and download status.

    Hide response attribute Show response attribute object
    • geoip_download_manager object
      Hide geoip_download_manager attributes Show geoip_download_manager attributes object
      • database object
        Hide database attributes Show database attributes object
        • ASN object
          Hide ASN attributes Show ASN attributes object
          • status string

            The status of the database license.

            Values are init, up_to_date, to_be_expired, or expired.

          • fail_check_in_days integer

            The number of days since the last successful check.

          • last_updated_at string(date-time)

            The last update timestamp.

        • CITY object
          Hide CITY attributes Show CITY attributes object
          • status string

            The status of the database license.

            Values are init, up_to_date, to_be_expired, or expired.

          • fail_check_in_days integer

            The number of days since the last successful check.

          • last_updated_at string(date-time)

            The last update timestamp.

      • download_stats object
        Hide download_stats attributes Show download_stats attributes object
        • successes integer

          The number of successful checks and downloads

        • failures integer

          The number of failed check or downloads

        • last_checked_at string(date-time)
        • status string

          The last download status.

          Values are succeeded, failed, or updating.
GET /_node/stats/geoip_download_manager 
curl \
 --request GET 'http://api.example.com/_node/stats/geoip_download_manager' \
 --user "username:password"
Response examples (200) 
{
  "geoip_download_manager": {
    "database": {
      "ASN": {
        "status": "init",
        "fail_check_in_days": 42,
        "last_updated_at": "2025-05-04T09:42:00Z"
      },
      "CITY": {
        "status": "init",
        "fail_check_in_days": 42,
        "last_updated_at": "2025-05-04T09:42:00Z"
      }
    },
    "download_stats": {
      "successes": 42,
      "failures": 42,
      "last_checked_at": "2025-05-04T09:42:00Z",
      "status": "succeeded"
    }
  }
}