Public Registry

List catalog categories

Changed on

Flat, id-based list of category nodes (top groups, leaf categories, provider nodes) with live endpoint counts and the exact catalog total. Use the returned id values with GET /public/v1/endpoints?category=… (+ optional q=).

get/public/v1/categories

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/public/v1/categories
  • Auth: none declared

Query parameters

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
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
categorystring

Node id filter. A TOP id returns the top plus its member nodes; a leaf/provider id returns that single node. Omit for every node.

Example:social-media
qstring

Optional free-text query — counts become per-node search hit counts (same BM25 semantics as GET /public/v1/endpoints?q=). Nodes with zero hits are omitted.

Example:twitter

Response

Category nodes

totalEndpointCountinteger required

Exact number of catalog-visible endpoints (with q: matching the query) — drives the All rail count.

Example response

{
  "items": [
    {
      "noMarkup": "all"
    }
  ]
}

Changes

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status