Public Registry

List or search endpoints

Cursor-paginated flat list of endpoint cards. Pass category to narrow to a category node (ids from GET /public/v1/categories), provider to narrow to one provider's endpoints, and/or q for BM25 keyword ranking.

get/public/v1/endpoints

Query parameters

limitinteger

Max items per page (server-side cap applies).

Example:20

Max items per page (server-side cap applies).

cursorstring

Cursor returned by the previous page.

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.

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.

x402Networkstring

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.

Example:eip155:8453

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.

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.

effectsstring

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.

Example:creates,deletes

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.

qstring

Optional free-text query — BM25 keyword ranking over the endpoint catalog (endpoint copy, provider names, category names). Combinable with category.

Example:twitter scraper

Optional free-text query — BM25 keyword ranking over the endpoint catalog (endpoint copy, provider names, category names). Combinable with category.

categorystring

Category node id to filter by (top group, leaf category, or provider node id from GET /public/v1/categories).

Example:twitter

Category node id to filter by (top group, leaf category, or provider node id from GET /public/v1/categories).

providerstring

Provider slug to narrow to (exact match). Combinable with q and category; an unknown slug returns an empty page.

Example:exa

Provider slug to narrow to (exact match). Combinable with q and category; an unknown slug returns an empty page.

Response

Endpoints page

cursorstring

Opaque cursor for the next page. Absent on the last page.

totalinteger

Total number of enabled endpoints matching the underlying query, irrespective of pagination.

Example response

{
  "items": [
    {
      "provider": "exa",
      "endpoint": "/search"
    }
  ]
}

Changes