Getting the country packet report for a specific month

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-reports/{period}.

Description

The Get-Country-Packet-Report request allows the user to request the aggregated country packet report for a specific month. For each country, the report contains the sum of the packets from the mitigations that ended in the reporting month, sorted by packet count in descending order.

Requirements

Values of the request: Month {period}

Objects: none

Request

To request the report for a specific month, add the Month {period} in the format YYYY-MM 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 country entries in data and a meta object with details about the reporting period. The structure of the response is identical to the request for the current month. See Getting the country packet report for the current month.

For months without aggregated data, the response contains an empty data list; last_updated_at is null in this case.

Example

Example response:

{
  "data": [
    {
      "country": "DE",
      "packets": 3023924
    },
    {
      "country": "FR",
      "packets": 529490
    }
  ],
  "meta": {
    "period_start": "2026-05-01",
    "period_end": "2026-05-31",
    "last_updated_at": "2026-06-01T00:35:00+00:00"
  }
}

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 month does not have a valid format.