Getting the country packet report for the current day

Note

This endpoint does not use the regular DataHub API authentication. Authentication is performed with a separate static token (configuration value COUNTRY_STATS_API_TOKEN) that is transmitted as a Bearer token in the Authorization header.

Sends a GET request to the endpoint /country-packet-daily-reports.

Description

The List-Country-Packet-Reports request allows the user to request the aggregated country packet report for the current day. For each country, the report contains the sum of the packets from the mitigations that ended on the reporting day, sorted by packet count in descending order.

The system re-aggregates the data every hour. The aggregation requires the feature flag COUNTRY_STATS_ENABLED; otherwise, the report stays empty.

Requirements

Values of the request: none

Objects: none

Request

To request the report for the current day, no additional information needs to be added to the path of the request.

As a result, the user gets a list of day entries in data. Each entry contains the date and the country entries in countries.

The entries provide the following information:

Attributes	Description	Values
date	The day for which the report is created.	string($date)
country	The ISO country code of the country.	string
packets	The aggregated number of packets for the country on the reporting day.	integer

Example

Example response:

{
  "data": [
    {
      "date": "2026-06-08",
      "countries": [
        {
          "country": "DE",
          "packets": 3023924
        },
        {
          "country": "US",
          "packets": 953069
        },
        {
          "country": "NL",
          "packets": 561701
        }
      ]
    }
  ]
}

Responses

The following responses are available:

STATUS CODE	DESCRIPTION
200	The request has succeeded.
401	The request has not succeeded because the Authorization header is missing or does not contain a Bearer token.
403	The request has not succeeded because the transmitted token is invalid.