Network

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.

get/v1/network/stats/history

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

stat'ap_switching' | 'cross_border' | 'smp_switching' | 'growth' | 'concentration_ap' | 'concentration_ap_country' | 'concentration_smp' | 'foreign_served' | 'penetration'

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).

fromstring date

Inclusive lower bound (YYYY-MM-DD UTC). Defaults to 90 days ago; clamped to 2026-08-02.

tostring date

Inclusive upper bound (YYYY-MM-DD UTC). Defaults to yesterday, the last complete day.

Response

The daily series of one statistic.

stat'ap_switching' | 'cross_border' | 'smp_switching' | 'growth' | 'concentration_ap' | 'concentration_ap_country' | 'concentration_smp' | 'foreign_served' | 'penetration' required
fromstring date required
tostring date required
sincestring date required
kind'flow' | 'stock' required
keysstring[] required

The keys of values. pct and mean_7d are computed on the first.

Changes

No recorded changes to this operation across all 1 revision of this API.