---
title: "List a participant's temporal history"
method: GET
path: "/v1/participants/{id}/history"
tags: ["Participants"]
---

# List a participant's temporal history

`GET /v1/participants/{id}/history`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/participants/{id}/history`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The participant's temporal rows across the directory/card/registration/SMP fact families, newest-first, cursor-paginated.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of history rows.

- ParticipantHistoryPage: A page of participant history rows.
  - `items` ParticipantHistoryRow[], required
    - `fact` 'directory_presence' | 'card' | 'registration' | 'smp', required
    - `valid_from` string, date-time, required
    - `valid_to` string, date-time, nullable, required
    - `detail` object, required
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null on the last page.

## Other responses

- `400`: An invalid `id`, `limit` or `cursor`.
- `404`: No such participant is known.

---

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