Getting the country packet report for a specific 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/{period}.

Description

The Get-Country-Packet-Report request allows the user to request the aggregated country packet report for a specific 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.

Requirements

Values of the request: Day {period}

Objects: none

Request

To request the report for a specific day, add the Day {period} in the format YYYY-MM-DD to the path of the request. A value in a different format leads to a 404 error.

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 structure of the response is identical to the request for the current day. See Getting the country packet report for the current day.

For days without aggregated data, the response contains an empty data list.

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.
404	The request was unsuccessful because the specified day does not have a valid format.