Skip to main content
GET
List catalogued providers
Returns every catalogued provider as a ProviderSummary. The list is bounded (one row per provider catalog entry, at most 32), so every answer is the whole list: limit does not cut it, meta.hasMore is false and there is no cursor. The three permissions must be held at the deployment root; see Who can read it.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

limit
integer

The list is bounded: at most 32 items, one row per provider catalog entry, a code registry. Every answer is the whole list, so meta.hasMore is false. limit (1 to 1000) does not cut it.

Required range: 1 <= x <= 1000
cursor
string

A bounded list issues no cursor: meta.nextCursor is always null, and any cursor is 400.

Minimum string length: 1

Response

Provider list

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.