Access Points

List access points

The Access Point directory: every Provider in its serving role, with its member seats and roster size (current participant count), busiest first. A Provider is resolved from each seat with the precedence curated mapping (verified) → exact signing-cert O= string (unverified) → bare SeatID. Not paginated (the envelope's next_cursor is always null). Pass ?country=CC to compare providers within one market instead of network-wide. Every item carries the windowed net growth; a MARKET-tier key additionally gets the four churn components behind each net (joiners, movers_in, movers_out, leavers × 7d/30d/90d), which a lower-tier key simply does not receive.

kind selects the row kinds. The default is provider, and the list is then Provider rows only. A Vendor is a curated software or service brand that connects its customers through the Seats of one or more Providers; kind=vendor returns the Vendor rows and kind=all returns both, each item marked by kind. A Vendor's participants are always also in the count of the Provider that serves them: never add Provider rows and Vendor rows into one total, share or rank.

get/v1/aps

Request

  • Base URL: https://api.peppolstatus.com
  • URL: https://api.peppolstatus.com/v1/aps
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

kind'provider' | 'vendor' | 'all'

Which row kinds to return. provider (default): Provider rows only. vendor: Vendor rows only. all: both, sorted together by participant_count. vendor and all need a MARKET-tier key; a lower-tier key gets a 403, never a list without the Vendors. Any other value is a 400.

countrystring

Scope the returned figures to one market: an ISO 3166-1 alpha-2 code (e.g. BE), case-insensitive. Anything that is not exactly two letters is a 400. When set, every item additionally carries country_roster, country_orgs and country_net_7d|30d|90d; the network-wide fields are unchanged. A MARKET-tier key additionally gets the scoped churn components country_joiners|movers_in|movers_out|leavers_7d|30d|90d. A Vendor row carries country_roster and country_orgs only: there is no country-scoped Vendor movement.

Response

The access point directory.

next_cursorstring nullable required

Opaque cursor for the next page, or null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.