> ## Documentation Index
> Fetch the complete documentation index at: https://monid.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List providers

> Cursor-paginated list of providers with their enabled-endpoint counts. Pass `q` to re-scope counts to matching endpoints.



## OpenAPI

````yaml https://monid.ai/openapi.json get /public/v1/providers
openapi: 3.1.0
info:
  title: Monid API
  version: 0.1.0
  description: >-
    Agentic payment platform for data — agents discover and buy data on demand.
    Authenticated `/v1/*` routes accept a Monid API key or Clerk JWT as a Bearer
    token. All errors return `{ code, message }`. List endpoints use cursor
    pagination; consult each operation schema for its last-page cursor encoding.
servers:
  - url: https://api.monid.ai
    description: Production
  - url: https://monid.ai
    description: Public registry alias (public/v1 only)
security: []
paths:
  /public/v1/providers:
    get:
      tags:
        - Public Registry
      summary: List providers
      description: >-
        Cursor-paginated list of providers with their enabled-endpoint counts.
        Pass `q` to re-scope counts to matching endpoints.
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            description: Max items per page (server-side cap applies).
            example: 20
          required: false
          description: Max items per page (server-side cap applies).
          name: limit
          in: query
        - schema:
            type: string
            description: Cursor returned by the previous page.
          required: false
          description: Cursor returned by the previous page.
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              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.
          required: false
          description: >-
            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.
          name: supportsX402
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 100
            description: >-
              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
          required: false
          description: >-
            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.
          name: x402Network
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              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.
          required: false
          description: >-
            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.
          name: readonly
          in: query
        - schema:
            type: string
            description: >-
              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
          required: false
          description: >-
            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.
          name: effects
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              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.
            example: twitter scraper
          required: false
          description: >-
            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.
          name: q
          in: query
      responses:
        '200':
          description: Providers page
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicProviderEntry'
                  cursor:
                    type: string
                    description: Opaque cursor for the next page. Absent on the last page.
                required:
                  - items
        '400':
          description: Bad request — input failed validation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PublicProviderEntry:
      type: object
      properties:
        provider:
          type: string
          description: Provider slug.
        displayName:
          type: string
          description: Resolved display label (curation > slug).
        displayDescription:
          type: string
        url:
          type: string
          format: uri
          description: >-
            Provider's public website. Absent when the provider declares none —
            never null, never empty. NOT the endpoint-level documentation URL
            (`docUrl`), which is served only on the endpoint detail and `POST
            /v1/inspect`.
          example: https://context.dev
        docsUrl:
          type: string
          format: uri
          description: >-
            Provider's own API documentation, when known. Absent otherwise —
            never null, never empty.
        endpointCount:
          type: integer
          minimum: 0
          description: Number of currently-enabled endpoints.
      required:
        - provider
        - displayName
        - endpointCount
    Error:
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code, duplicated in the body.
          example: 400
        message:
          type: string
          description: Human-readable error description.
          example: Bad Request
        hints:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: object
                properties:
                  kind:
                    type: string
                    enum:
                      - command
                      - discover
                      - inspect
                      - run
                      - getRun
                      - stop
                      - releaseResource
                      - topup
                  command:
                    type: string
                  query:
                    type: string
                  provider:
                    type: string
                  endpoint:
                    type: string
                  runId:
                    type: string
                  resourceId:
                    type: string
                  stripe:
                    type: string
                  dashboard:
                    type: string
                  docs:
                    type: string
                  comment:
                    type: string
                required:
                  - kind
          description: >-
            Optional next actions, rendered for the calling client like
            run-response hints (e.g. the paid TinyFish version on a free-quota
            429 — spending permission required).
        errorCode:
          type: string
          enum:
            - RATE_LIMITED
            - X402_WORKSPACE_RESOURCES
            - X402_WORKSPACE_ONLY
            - X402_ACCRUING_COST
            - X402_EXCEEDS_SETTLEMENT_WINDOW
            - X402_VALIDITY_WINDOW_TOO_SHORT
            - X402_UNBOUNDED_PRICE
            - X402_PROMOTION
            - INSUFFICIENT_SCOPE
            - WALLET_INSUFFICIENT_FUNDS
            - IDENTITY_PROVIDER_UNKNOWN
            - IDENTITY_LINK_REQUIRES_SESSION
            - IDENTITY_LINK_STATE_INVALID
            - IDENTITY_VERIFICATION_FAILED
            - IDENTITY_PROVIDER_UNAVAILABLE
            - IDENTITY_ALREADY_LINKED
            - IDENTITY_USER_ALREADY_LINKED
            - IDENTITY_LINK_RATE_LIMITED
            - IDENTITY_REQUIRED
            - PROMO_IDENTITY_REDEEMED
            - PROMO_REDEEM_REQUIRES_SESSION
            - PROMO_CODE_REDEEMED_BY_WORKSPACE
            - PROMO_CODE_REDEEMED_BY_USER
          description: >-
            OPTIONAL machine-readable discriminant from the documented
            `ApiErrorCode` registry. Absent on legacy errors; clients MUST treat
            unknown values as absent.
      required:
        - code
        - message

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.