Participants

Per-country participant churn

New (joiner) vs departed (leaver) participants for one country, as a daily series and an all-time monthly rollup, from the hourly churn rollup. A valid but unknown country returns empty arrays. Keyless-cacheable.

get/v1/stats/countries/{code}

Request

  • Base URL: https://api.peppolstatus.com
  • URL: https://api.peppolstatus.com/v1/stats/countries/{code}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

codestring required

Two-letter country code (ISO 3166-1 alpha-2), case-insensitive.

Query parameters

fromstring date

Inclusive lower bound of the daily series (YYYY-MM-DD UTC). Defaults to 30 days ago.

tostring date

Inclusive upper bound of the daily series (YYYY-MM-DD UTC). Defaults to today.

Response

The country's daily + monthly participant churn.

countrystring required

The normalized (uppercase) country code.

churn_epochstring date required

The date joiner counting begins (earlier is backfill, not churn).

unique_organizationsinteger nullable

Distinct organizations behind this country's participant IDs (derived company_key), or null until the rollup has computed it (issue #451).

Changes

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