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

List or search endpoints

cURL

curl --request GET \
  --url https://api.monid.ai/public/v1/endpoints

200

{
  "items": [
    {
      "provider": "exa",
      "providerDisplayName": "<string>",
      "endpoint": "/search",
      "displayName": "<string>",
      "displayDescription": "<string>",
      "price": {
        "type": "<string>",
        "amount": {
          "value": 123,
          "currency": "USD"
        },
        "flatFee": {
          "value": 123,
          "currency": "USD"
        },
        "period": {
          "unit": "MINUTE",
          "count": 123
        },
        "per": {
          "unit": "MINUTE",
          "count": 123
        },
        "unit": "token",
        "default": {
          "type": "PER_CALL",
          "amount": {
            "value": 123,
            "currency": "USD"
          }
        },
        "selectors": [
          {
            "label": "<string>",
            "key": "<string>",
            "in": "body",
            "offset": 1
          }
        ],
        "variants": [
          {
            "when": {},
            "price": {
              "type": "PER_CALL",
              "amount": {
                "value": 123,
                "currency": "USD"
              }
            },
            "label": "<string>"
          }
        ],
        "tiers": [
          {
            "label": "<string>",
            "price": {
              "type": "PER_CALL",
              "amount": {
                "value": 123,
                "currency": "USD"
              }
            },
            "when": {},
            "selector": {
              "label": "<string>",
              "key": "<string>",
              "in": "body",
              "offset": 1
            }
          }
        ]
      },
      "tags": [
        "<string>"
      ],
      "categories": [
        "<string>"
      ],
      "supportedX402Networks": [
        "<string>"
      ],
      "providerDisplayDescription": "<string>",
      "promotion": {
        "campaignId": "<string>",
        "label": "<string>",
        "discountPercent": 123,
        "limits": {
          "perMinute": 123,
          "perHour": 123,
          "perDay": 123
        },
        "baseEndpoint": "<string>",
        "listPrice": {
          "type": "<string>",
          "amount": {
            "value": 123,
            "currency": "USD"
          },
          "flatFee": {
            "value": 123,
            "currency": "USD"
          },
          "period": {
            "unit": "MINUTE",
            "count": 123
          },
          "per": {
            "unit": "MINUTE",
            "count": 123
          },
          "unit": "token",
          "default": {
            "type": "PER_CALL",
            "amount": {
              "value": 123,
              "currency": "USD"
            }
          },
          "selectors": [
            {
              "label": "<string>",
              "key": "<string>",
              "in": "body",
              "offset": 1
            }
          ],
          "variants": [
            {
              "when": {},
              "price": {
                "type": "PER_CALL",
                "amount": {
                  "value": 123,
                  "currency": "USD"
                }
              },
              "label": "<string>"
            }
          ],
          "tiers": [
            {
              "label": "<string>",
              "price": {
                "type": "PER_CALL",
                "amount": {
                  "value": 123,
                  "currency": "USD"
                }
              },
              "when": {},
              "selector": {
                "label": "<string>",
                "key": "<string>",
                "in": "body",
                "offset": 1
              }
            }
          ]
        }
      }
    }
  ],
  "cursor": "<string>",
  "total": 1
}

Query Parameters

limit · integer

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

Example:

20

cursor · string

Cursor returned by the previous page.

supportsX402 · enum<string>

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.

Available options: true, false

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.

Required string length: 1 - 100

Example:

"eip155:8453"

readonly · enum<string>

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.

Available options: true, false

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.

Example:

"creates,deletes"

q · string

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

Required string length: 1 - 200

Example:

"twitter scraper"

category · string

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

Maximum string length: 60

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Example:

"twitter"

provider · string

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

Minimum string length: 1

Example:

"exa"

promotion · enum<string>

Limited-time promotions: active = only active promotion endpoints (/promo/..., the "Promotion endpoints" group); exclude = no promotion endpoints. Omit for everything.

Available options: active, exclude

Example:

"active"

Response

200

application/json

Endpoints page

items · object[] · required

Show child attributes

cursor · string

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

total · integer

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

Required range: x >= 0