---
title: "Get the provider roster-size spread per country"
method: GET
path: "/v1/stats/provider-roster-spread"
tags: ["Participants"]
---

# Get the provider roster-size spread per country

`GET /v1/stats/provider-roster-spread`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/stats/provider-roster-spread`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

How Access Point provider roster sizes are spread in each country, in one call. A roster size is the number of participant IDs one provider serves in the country (`country_roster` of `GET /v1/aps?country=`). Each country row is the five-number summary over the providers with at least one participant there: `n` providers, `min`, `q1`, `median`, `q3`, `max`, and `total` (the sum). Quantiles use linear interpolation between the two closest ranks (type 7), rounded to 2 decimals.

`points` is every roster size in ascending order when the country has fewer than `points_max` providers, and null at or above it. The response carries sizes only, no provider key or name. Countries are ordered by median, largest first. A summary of a country with few providers says little: the console does not draw a country with fewer than 8.

## Response `200`

The roster-size spread of every country, largest median first.

- object
  - `as_of` string, date-time, nullable, required: When the directory rollup behind the figures last ran.
  - `points_max` integer, required: A country with this many providers or more has `points: null`.
  - `countries` object[], required
    - `country` string, required: ISO 3166-1 alpha-2, uppercase.
    - `n` integer, required: Providers with at least one participant in the country.
    - `total` integer, required: Sum of the roster sizes: provider-served IDs in the country.
    - `min` integer, required: Smallest roster.
    - `q1` number, required: First quartile.
    - `median` number, required: Median roster.
    - `q3` number, required: Third quartile.
    - `max` integer, required: Largest roster.
    - `points` integer[], nullable, required: Every roster size, ascending; null for a large country.

---

[API](https://skmtc.dev/peppolstatus/apis/peppolstatus-api.md) · [All operations](https://skmtc.dev/peppolstatus/apis/peppolstatus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peppolstatus/apis/peppolstatus-api/revisions/7e74fb32f23c?raw)