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

# List a participant's change events

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

## Request

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

The participant's typed change events, newest-first, cursor-paginated.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of change events.

- ParticipantEventPage: A page of participant change events.
  - `items` ParticipantEvent[], required
    - `id` string, required
    - `type` 'participant_registered' | 'participant_deregistered' | 'participant_smp_changed' | 'endpoint_changed' | 'doctype_support_changed' | 'ap_seat_changed' | 'host_cert_rotated' | 'hosting_changed' | 'directory_card_changed', required
    - `observed_at` string, date-time, required
    - `payload` object, required: Type-specific change detail. An `endpoint_changed` event is one row per real (from, to, transportProfile) change and lists the affected document types in a `doctypes` array; rows written before the merge carry a singular `doctype`.
  - `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)