---
title: "List the latest De-registered IDs"
method: GET
path: "/v1/stats/deregistered/ids"
tags: ["Participants"]
---

# List the latest De-registered IDs

`GET /v1/stats/deregistered/ids`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/stats/deregistered/ids`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The De-registered IDs of `/v1/stats/deregistered` (same population, same daily rollup) with the newest leave date: at most 1000, newest first, cursor-paginated. Each item is a `/v1/participants` list item plus `left_at`, the close of its latest registration.

`left_at` is recorded about 3 days after the true leave, and a date before 2026-08-02 is not reliable. An ID that is registered again since the rollup run is left out, so a page can be shorter than `total` says. `/v1/participants?registered=false` is a wider list: it also holds the never-registered IDs, which are not de-registered.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The latest De-registered IDs.

- DeregisteredIds
  - `as_of` string, date, nullable, required: Day of the rollup run. null = no rollup run yet.
  - `refreshed_at` string, date-time, nullable, required
  - `total` integer, required: IDs the rollup kept: at most 1000 of the `deregistered` total of `/v1/stats/deregistered`.
  - `items` DeregisteredIdItem[], required
    - `id` string, required: Canonical `scheme::value`.
    - `scheme` string, required
    - `value` string, required
    - `name` string, nullable, required: Current card name; null for discovered participants.
    - `company_name` string, nullable, required: Company-register legal name (KBO/SIRENE via participant_company_link), a display fallback when `name` (the business card) is null. Withheld (null) for natural persons per the §10 name gate; not sortable/searchable.
    - `country` string, nullable, required: Current card country; null for discovered participants.
    - `registered` boolean, required: Currently registered in the SML.
    - `smp` string, nullable, required: Current SMP hostname, or null.
    - `ap_seat_id` string, nullable, required: Serving Access Point SeatID, or null before the deep SMP fetch.
    - `ap_provider` string, nullable, required: Curated provider name behind that Seat, or null when unmapped.
    - `provenance` 'directory' | 'discovered', required
    - `first_seen_at` string, date-time, required
    - `company_entity_type` string, nullable, required: Company legal-form family (company|natural_person|association|public), or null when unmatched.
    - `company_sector` string, nullable, required: Company NACE Rev. 2.1 division (2-digit, one of 87; never 45), or null. Derived from the register code by its nomenclature: a Rev. 1-era code (e.g. NAF 1993, NACE-BEL 2003) gives null.
    - `company_size` string, nullable, required: Company size band code, or null. Stored codes: the INSEE trancheEffectifs codes for FR (e.g. `21`; `NN` = unknown), and for NO the same code set plus `1-4`. No other register has a size.
    - `company_region` string, nullable, required: Company seat region code, or null. A bare INSEE région code for FR (e.g. `84`); ISO 3166-2 for BE, NO and SK (e.g. `BE-VLG`). No other register has a region.
    - `company_size_label` string, nullable, required: English size band label of company_size (e.g. 21 → "50–99 employees", NN → "Size unknown"). Equal to the code when the code is unknown; null when company_size is null.
    - `company_region_label` string, nullable, required: Region name of company_region in the local language (e.g. 84 → "Auvergne-Rhône-Alpes", BE-VLG → "Flanders"). Equal to the code when the code is unknown; null when company_region is null.
    - `company_postcode` string, nullable, required: Company seat postcode, or null.
    - `company_vat_liable` boolean, nullable, required: Company VAT-liable / mandate-scope flag, or null.
    - `left_at` string, date-time, required: Close of the latest registration: recorded about 3 days after the true leave, and not reliable before 2026-08-02.
  - `next_cursor` string, nullable, required

## Other responses

- `400`: An invalid `limit` or `cursor`.

---

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