---
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.
- `supportsX402` 'true' | 'false' — Filter by static eligibility for x402 payment (`POST /x402/v1/run`): `true` keeps only payable endpoints, `false` only non-payable ones. Omit for all endpoints.
- `x402Network` string — Narrow to endpoints payable via x402 on this customer-payment network (CAIP-2 id, e.g. `eip155:8453`). Implies `supportsX402=true`; an unknown/unconfigured id returns an empty page.
- `readonly` 'true' | 'false' — Filter by whether running the endpoint can change your workspace resources (phone numbers, files, asset libraries): `true` keeps only endpoints that cannot create, modify or delete them, `false` only endpoints that can. Omit for all endpoints. This describes RESOURCE effects only — a readonly endpoint may still perform real-world actions and is still billed.
- `effects` string — Keep only endpoints whose run can have AT LEAST ONE of the named effects on your workspace resources (phone numbers, files, asset libraries): `creates`, `updates`, `deletes`. Omit for all endpoints. Takes precedence over `readonly` (`readonly=true` is the alias for "no write effects"). Resource effects only — an endpoint with no effect may still perform real-world actions and is still billed.
- `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
    - `url` string, uri — Provider's public website. Absent when the provider declares none — never null, never empty. NOT the endpoint-level documentation URL (`docUrl`), which stays private to `POST /v1/inspect`.
    - `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

## Changes

- **2026-09-25** `5abada71ceae` — 26 warning, 1 info
  - added the new `IDENTITY_ALREADY_LINKED` enum value to the `errorCode` response property for the response status `400`
  - added the new `IDENTITY_ALREADY_LINKED` enum value to the `errorCode` response property for the response status `500`
  - added the new `IDENTITY_LINK_RATE_LIMITED` enum value to the `errorCode` response property for the response status `400`
  - added the new `IDENTITY_LINK_RATE_LIMITED` enum value to the `errorCode` response property for the response status `500`
  - …23 more
- **2026-09-23** `fadab791136c` — 2 warning, 1 info
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `400`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `500`
  - added the new optional `query` request parameter `readonly`
- **2026-09-11** `9874d9e34fcf` — 4 info
  - added the new optional `query` request parameter `supportsX402`
  - added the new optional `query` request parameter `x402Network`
  - added the optional property `errorCode` to the response with the `400` status
  - added the optional property `errorCode` to the response with the `500` status
- **2026-08-16** `6a927c84fe15` — 1 info
  - added the optional property `items/items/url` to the response with the `200` status

[Change history](https://skmtc.dev/monid/apis/monid-api/changes/public/v1/providers/get.md)

---

[API](https://skmtc.dev/monid/apis/monid-api.md) · [All operations](https://skmtc.dev/monid/apis/monid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monid/apis/monid-api/revisions/5abada71ceae?raw)