Get one network-level statistic as a daily series
One point for every UTC day of the window. stat is required. A flow statistic (ap_switching = Movers (AP), cross_border = Cross-border moves, smp_switching = Movers (SMP), growth = Net growth with Joiners and Leavers) carries per day its counts (values), the registered-participant count at the start of the day (base), the first key as a percentage of that base (pct) and its 7-day mean (mean_7d). For cross_border, base is all AP moves of the day and pct is the cross-border share of them. A day with no completed change scan has gap: true and values: null — a gap is never 0. The 7-day mean is the mean over the scanned days of day − 6 .. day: a gap day is in neither the sum nor the divisor, and the mean is null when all are gaps. It is the same figure as trend_30d of /v1/network/stats. For growth, a gap day keeps joiners and nulls leavers and net. A stock statistic (concentration_ap = Concentration (AP), concentration_ap_country = Concentration per country, concentration_smp = Concentration (SMP), foreign_served = Foreign-served participants, penetration) carries values, null on a day with no snapshot; foreign_served also carries base, the registered participants of that day. concentration_ap, concentration_ap_country, foreign_served and penetration have no history before their first snapshot. A day with no snapshot is absent, not 0. The series starts 2026-08-02.
Request
- Base URL: https://api.peppolstatus.com
- URL: https://api.peppolstatus.com/v1/network/stats/history
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
REQUIRED. The statistic to return: ap_switching (keys total, organic, bulk, platform), cross_border (cross, same, unknown, strict_cross, strict_unknown), smp_switching (total), growth (net, joiners, leavers), concentration_ap / concentration_smp (cr5_pct, cr10_pct, hhi, total, providers), concentration_ap_country (per country with 8 or more providers: hhi, effective_providers, leader_pct, top4_pct, top10_pct, providers_over_1pct, providers, total), foreign_served (pct, foreign, domestic, unknown) or penetration (per country: pct, on_peppol, universe).
Inclusive lower bound (YYYY-MM-DD UTC). Defaults to 90 days ago; clamped to 2026-08-02.
Inclusive upper bound (YYYY-MM-DD UTC). Defaults to yesterday, the last complete day.
Response
The daily series of one statistic.
Changes
No recorded changes to this operation across all 1 revision of this API.