> ## 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.

# Get one endpoint

> Fetch a single public endpoint card. `endpoint` is the endpoint path and may itself contain slashes (e.g. `apidojo/tweet-scraper`).



## OpenAPI

````yaml https://monid.ai/openapi.json get /public/v1/providers/{provider}/endpoints/{endpoint}
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/{provider}/endpoints/{endpoint}:
    get:
      tags:
        - Public Registry
      summary: Get one endpoint
      description: >-
        Fetch a single public endpoint card. `endpoint` is the endpoint path and
        may itself contain slashes (e.g. `apidojo/tweet-scraper`).
      parameters:
        - schema:
            type: string
            example: apify
          required: true
          name: provider
          in: path
        - schema:
            type: string
            description: Endpoint path; may contain slashes.
            example: apidojo/tweet-scraper
          required: true
          description: Endpoint path; may contain slashes.
          name: endpoint
          in: path
      responses:
        '200':
          description: Endpoint detail
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicEndpointDetail'
        '404':
          description: Endpoint not found (missing or disabled)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PublicEndpointDetail:
      allOf:
        - $ref: '#/components/schemas/PublicEndpointInfo'
        - type: object
          properties:
            summary:
              type: string
              description: Rich long-form endpoint detail, when authored.
            method:
              type: string
              description: HTTP method for this endpoint.
            docUrl:
              type: string
              format: uri
              description: The vendor's docs page for this endpoint, when known.
            hints:
              type: object
              additionalProperties: {}
              description: >-
                Raw structured agent-guidance hints (phrase → target), when
                authored on the endpoint. Cross-links related endpoints in
                multi-step workflows.
    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
    PublicEndpointInfo:
      type: object
      properties:
        provider:
          type: string
          description: Provider slug.
          example: exa
        providerDisplayName:
          type: string
          description: Resolved provider display name (curation > slug).
        providerDisplayDescription:
          type: string
          description: Resolved provider display blurb.
        endpoint:
          type: string
          description: Endpoint path.
          example: /search
        displayName:
          type: string
          description: Resolved endpoint display label. Always populated.
        displayDescription:
          type: string
          description: Resolved endpoint display blurb. May be empty.
        price:
          $ref: '#/components/schemas/PublicPrice'
        tags:
          type: array
          items:
            type: string
          description: >-
            User-facing tags (e.g. `["verified", "no-markup"]`). `no-markup` =
            priced at the provider's standard rate with no platform fee added.
            Always an array; empty when no tags are set on the indexed wrapper.
        categories:
          type: array
          items:
            type: string
          description: >-
            Depth-2 category paths — authored functional paths AND derived
            provider placement paths (e.g. `["social-media/twitter",
            "scrapers/apify"]`), treated uniformly. Bare top-level ancestors are
            excluded. Empty when the endpoint is outside the category catalog.
        promotion:
          type: object
          properties:
            campaignId:
              type: string
            label:
              type: string
              description: Badge text, e.g. "50% OFF · Limited time".
            discountPercent:
              type: integer
            baseEndpoint:
              type: string
              description: >-
                The regular-price endpoint this promotion discounts; absent on a
                standalone promotion (not a copy of another endpoint).
            limits:
              type: object
              properties:
                perMinute:
                  type: integer
                perHour:
                  type: integer
                perDay:
                  type: integer
              required:
                - perMinute
                - perHour
                - perDay
              description: Per-workspace call limits on this promotion endpoint.
            listPrice:
              allOf:
                - $ref: '#/components/schemas/PublicPrice'
                - description: >-
                    The regular price of `baseEndpoint` (strike-through); absent
                    when there is no base.
          required:
            - campaignId
            - label
            - discountPercent
            - limits
          description: >-
            Present ONLY on a limited-time promotion endpoint (`/promo/...`): a
            discounted copy of `baseEndpoint` — or a standalone offer without
            one — with stricter per-workspace limits, available while the
            campaign lasts.
        supportedX402Networks:
          type: array
          items:
            type: string
          description: >-
            Customer-payment networks (CAIP-2 ids, e.g. `["eip155:8453",
            "eip155:143"]`) this endpoint can be paid for through `POST
            /x402/v1/run`. Empty when the endpoint is not x402-eligible
            (workspace-resource coupling, cost accrual, settlement-window fit,
            or visibility). Static protocol/policy compatibility — network
            availability and request/payment validation are checked at execution
            time.
      required:
        - provider
        - providerDisplayName
        - endpoint
        - displayName
        - displayDescription
        - price
        - tags
        - categories
        - supportedX402Networks
    PublicPrice:
      type: object
      properties:
        type:
          type: string
        amount:
          type: object
          properties:
            value:
              type: number
            currency:
              type: string
              enum:
                - USD
          required:
            - value
            - currency
        flatFee:
          type: object
          properties:
            value:
              type: number
            currency:
              type: string
              enum:
                - USD
          required:
            - value
            - currency
        period:
          type: object
          properties:
            unit:
              type: string
              enum:
                - MINUTE
                - DAY
                - MONTH
            count:
              type: integer
              exclusiveMinimum: 0
          required:
            - unit
            - count
        per:
          anyOf:
            - type: object
              properties:
                unit:
                  type: string
                  enum:
                    - MINUTE
                    - DAY
                    - MONTH
                count:
                  type: integer
                  exclusiveMinimum: 0
              required:
                - unit
                - count
            - type: number
        unit:
          type: string
          enum:
            - token
            - character
            - second
            - image
            - credit
            - result
            - gb-month
            - step
            - byte
            - url
            - page
        default:
          anyOf:
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - PER_CALL
                amount:
                  type: object
                  properties:
                    value:
                      type: number
                    currency:
                      type: string
                      enum:
                        - USD
                  required:
                    - value
                    - currency
              required:
                - type
                - amount
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - PER_RESULT
                amount:
                  type: object
                  properties:
                    value:
                      type: number
                    currency:
                      type: string
                      enum:
                        - USD
                  required:
                    - value
                    - currency
                flatFee:
                  type: object
                  properties:
                    value:
                      type: number
                    currency:
                      type: string
                      enum:
                        - USD
                  required:
                    - value
                    - currency
              required:
                - type
                - amount
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - METERED
                amount:
                  type: object
                  properties:
                    value:
                      type: number
                    currency:
                      type: string
                      enum:
                        - USD
                  required:
                    - value
                    - currency
                per:
                  type: object
                  properties:
                    unit:
                      type: string
                      enum:
                        - MINUTE
                        - DAY
                        - MONTH
                    count:
                      type: integer
                      exclusiveMinimum: 0
                  required:
                    - unit
                    - count
              required:
                - type
                - amount
                - per
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - PER_UNIT
                amount:
                  type: object
                  properties:
                    value:
                      type: number
                    currency:
                      type: string
                      enum:
                        - USD
                  required:
                    - value
                    - currency
                per:
                  type: number
                unit:
                  type: string
                  enum:
                    - token
                    - character
                    - second
                    - image
                    - credit
                    - result
                    - gb-month
                    - step
                    - byte
                    - url
                    - page
              required:
                - type
                - amount
                - per
                - unit
        selectors:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
              key:
                type: string
              in:
                type: string
                enum:
                  - body
                  - queryParam
                  - pathParam
                  - output
              offset:
                type: integer
                minimum: 0
            required:
              - label
              - key
              - in
        variants:
          type: array
          items:
            type: object
            properties:
              when:
                type: object
                additionalProperties:
                  anyOf:
                    - type: string
                    - type: number
                    - type: boolean
              price:
                anyOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_CALL
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                    required:
                      - type
                      - amount
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_RESULT
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      flatFee:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                    required:
                      - type
                      - amount
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - METERED
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      per:
                        type: object
                        properties:
                          unit:
                            type: string
                            enum:
                              - MINUTE
                              - DAY
                              - MONTH
                          count:
                            type: integer
                            exclusiveMinimum: 0
                        required:
                          - unit
                          - count
                    required:
                      - type
                      - amount
                      - per
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_UNIT
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      per:
                        type: number
                      unit:
                        type: string
                        enum:
                          - token
                          - character
                          - second
                          - image
                          - credit
                          - result
                          - gb-month
                          - step
                          - byte
                          - url
                          - page
                    required:
                      - type
                      - amount
                      - per
                      - unit
              label:
                type: string
            required:
              - when
              - price
        tiers:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
              when:
                type: object
                additionalProperties:
                  anyOf:
                    - type: string
                    - type: number
                    - type: boolean
              selector:
                type: object
                properties:
                  label:
                    type: string
                  key:
                    type: string
                  in:
                    type: string
                    enum:
                      - body
                      - queryParam
                      - pathParam
                      - output
                  offset:
                    type: integer
                    minimum: 0
                required:
                  - label
                  - key
                  - in
              price:
                anyOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_CALL
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                    required:
                      - type
                      - amount
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_RESULT
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      flatFee:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                    required:
                      - type
                      - amount
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - METERED
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      per:
                        type: object
                        properties:
                          unit:
                            type: string
                            enum:
                              - MINUTE
                              - DAY
                              - MONTH
                          count:
                            type: integer
                            exclusiveMinimum: 0
                        required:
                          - unit
                          - count
                    required:
                      - type
                      - amount
                      - per
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - PER_UNIT
                      amount:
                        type: object
                        properties:
                          value:
                            type: number
                          currency:
                            type: string
                            enum:
                              - USD
                        required:
                          - value
                          - currency
                      per:
                        type: number
                      unit:
                        type: string
                        enum:
                          - token
                          - character
                          - second
                          - image
                          - credit
                          - result
                          - gb-month
                          - step
                          - byte
                          - url
                          - page
                    required:
                      - type
                      - amount
                      - per
                      - unit
            required:
              - label
              - price
      required:
        - type
        - amount
      description: User-facing price (markup applied).

````

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