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.

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.

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.

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

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

Changed in 8 of the 22 revisions of this API.1489

Sep 25, 20265abada71ceae261See the full diff
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter effects
  new-optional-request-parameter
Sep 23, 2026fadab791136c61See the full diff
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new step enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new step enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new step enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new step enum value to the /////// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter readonly
  new-optional-request-parameter
Sep 18, 2026cb05b702253d4See the full diff
- ●
  added the new gb-month enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new gb-month enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gb-month enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new gb-month enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 11, 20269874d9e34fcf5See the full diff
- ○
  added the new optional query request parameter supportsX402
  new-optional-request-parameter
- ○
  added the new optional query request parameter x402Network
  new-optional-request-parameter
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 8, 202655459af576974See the full diff
- ●
  added the new result enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new result enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new result enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new result enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 4, 202682b3227479132See the full diff
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Sep 2, 20269a70c30542a14See the full diff
- ●
  added the new credit enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new credit enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new credit enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new credit enum value to the /////// response property for the response status
  response-property-enum-value-added
Aug 19, 202662672126673714See the full diff
- ▲
  the response property ///// became optional for the status
  response-property-became-optional
- ●
  added the new image enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new image enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new image enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new image enum value to the /////// response property for the response status
  response-property-enum-value-added

Full history