---
title: "Document-type landscape"
method: GET
path: "/v1/stats/doctypes"
tags: ["Doctypes"]
---

# Document-type landscape

`GET /v1/stats/doctypes`

## Request

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

The free document-type landscape (issue #647): per-family participant share (Invoice, Order, Credit Note, …), the wildcard-doctype bucket, and the participant denominator. Read from the pre-computed doctype rollup tables and edge-cached. Keyless-cacheable.

## Response `200`

The document-type landscape aggregates.

- object
  - `families` object[], required: Per-family cells, sorted by participants desc.
    - `family` string, required
    - `doctypes` integer, required
    - `participants` integer, required
    - `share` number, required
  - `wildcard` object, required: The wildcard-doctype bucket (participants + distinct doctype count).
    - `participants` integer, required
    - `count` integer, required
  - `total_participants` integer, required
  - `generated_at` string, date-time, required

---

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