---
title: "Participant facet history"
method: GET
path: "/v1/stats/participants/history"
tags: ["Participants"]
---

# Participant facet history

`GET /v1/stats/participants/history`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/stats/participants/history`
- Auth: none required

A daily time series over one participant facet dimension (adoption curves / QoQ trends), from daily snapshots of the rollup. History accrues from the day the feature shipped. Keyless-cacheable.

## Query parameters

- `dimension` 'total' | 'country' | 'scheme' | 'registered' | 'provenance' | 'smp' | 'ap' | 'doctype' | 'transport_profile' | 'entity_type' | 'sector' | 'size' | 'region' | 'vat_liable' | 'unique_organizations', required
- `key` string[]
- `from` string, date
- `to` string, date
- `limit` integer

## Response `200`

The participant facet time series.

- ParticipantStatsHistory: A daily time series over one participant facet dimension.
  - `dimension` 'total' | 'country' | 'scheme' | 'registered' | 'provenance' | 'smp' | 'ap' | 'doctype' | 'transport_profile' | 'entity_type' | 'sector' | 'size' | 'region' | 'vat_liable' | 'unique_organizations', required
  - `from` string, date, required
  - `to` string, date, required
  - `series` StatsHistoryPoint[], required: Points ordered by day ascending, then key.
    - `day` string, date, required: UTC calendar day (YYYY-MM-DD).
    - `key` string, required: The facet key (or `total`).
    - `count` integer, required

## Other responses

- `400`: An invalid `dimension`, `from`, `to` or `limit`.

---

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