---
title: "List providers"
method: GET
path: "/public/v1/providers"
tags: ["Public Registry"]
---

# List providers

`GET /public/v1/providers`

Cursor-paginated list of providers with their enabled-endpoint counts. Pass `q` to re-scope counts to matching endpoints.

## Query parameters

- `limit` integer — Max items per page (server-side cap applies).
- `cursor` string — Cursor returned by the previous page.
- `q` string — Optional free-text query. Counts become matching-endpoint counts (the same lexical matching as the endpoint search, aggregated by provider); providers with zero matches are omitted.

## Response `200`

Providers page

- object
  - `items` PublicProviderEntry[], required
    - `provider` string, required — Provider slug.
    - `displayName` string, required — Resolved display label (curation > slug).
    - `displayDescription` string
    - `endpointCount` integer, required — Number of currently-enabled endpoints.
  - `cursor` string — Opaque cursor for the next page. Absent on the last page.

## Other responses

- `400` — Bad request — input failed validation
- `500` — Internal server error

---

[API](https://skmtc.net/monid/apis/monid-api.md) · [All operations](https://skmtc.net/monid/apis/monid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monid/monid-api/versions/164b6b6f2d36/schema)