MeetMyAgent Billing API

Plans: Free and AI Shop through Stripe (existing Business subscriptions retain their terms) (plan and usage, checkout, customer portal, webhook)

GitHub OpenAPI

Operations 8

GET /v1/billing The account's plan (Free or AI Shop; legacy Business contracts are reported as… #
POST /v1/billing/checkout Start a Stripe checkout for the AI Shop plan. #
POST /v1/billing/complimentary Admin only: grant AI Shop without charge until an explicit future end date or… #
POST /v1/billing/portal Open the Stripe customer portal (invoices, payment method, cancellation) once a… #
POST /v1/billing/stripe-webhook Stripe webhook for the plans (signature-verified; events without the… #
POST /v1/billing/cancellation Cancel the MeetMyAgent AI Shop or a legacy Business subscription (Verträge hier… #
GET /v1/billing/cancellation The account's own cancellations to a later day that are still waiting… #
POST /v1/billing/cancellation/undo Take a scheduled cancellation back before it takes effect, also one for a later… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/meetmyagent-io:meetmyagent-io-billing-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

meetmyagent-io-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MeetMyAgent Billing API
  version: 0.6.0
  description: 'The API behind MeetMyAgent: AI agents for creators, developers, authors and small businesses. Hosted agents expose their supplied knowledge and services; visitors'' assistants use suitable A2A or MCP tools to ask questions. Enquiries require the user''s permission and are not confirmed purchases. Agents do not buy. When someone wants to buy an offer, the agent shows the provider''s checkoutUrl, and the person completes the purchase on the provider''s own checkout page. MeetMyAgent does not process offer purchases. Owners manage knowledge, requests and install data; the directory lists only eligible live hosted agents (Free and AI Shop) with complete profiles, required offer disclosures and at least one current proof. External cards remain owner connections. Platform endpoints return the envelope `{ success, result, errors[], messages[], result_info?, links?, request_id }`; ACP /checkout_sessions and UCP /v1/ucp/catalog return their raw, versioned protocol JSON. Error codes are stable (slug + numeric) and documented per response. Writes accept `Idempotency-Key`. Start with GET /v1/skill.md (the one-document agent operator guide). Named result contracts are generated from route serializers and shared output schemas. Any remaining untyped JSON operations are reported by the repository contract inventory; the TypeScript SDK (`meetmyagent-sdk`) also publishes client types.


    /v1 is the stable URL contract. OpenAPI info.version identifies the document version, not a new URL contract. ACP checkout uses its own dated API-Version contract. Removing a field or route, changing a field type, or adding a required parameter is a breaking change; adding optional fields or new routes is additive. Before removing a deprecated route, we announce it at least six calendar months in advance in the changelog, with deprecated: true on the affected OpenAPI operation and with Deprecation and Sunset headers on its responses. No route is currently deprecated.'
  contact:
    name: MeetMyAgent
    url: https://meetmyagent.io/en/api
    email: hello@meetmyagent.io
servers:
- url: https://meetmyagent.io
tags:
- name: Billing
  description: 'Plans: Free and AI Shop through Stripe (existing Business subscriptions retain their terms) (plan and usage, checkout, customer portal, webhook)'
paths:
  /v1/billing:
    get:
      operationId: get_billing
      summary: The account's plan (Free or AI Shop; legacy Business contracts are reported as…
      tags:
      - Billing
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/get_v1_billing_Result'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/billing.ts:770
  /v1/billing/checkout:
    post:
      operationId: post_billing_checkout
      summary: Start a Stripe checkout for the AI Shop plan.
      description: 'Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`.'
      tags:
      - Billing
      security:
      - bearerAuth: []
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
        description: Reuse the same key and payload for a retry. A changed payload is rejected.
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/get_v1_auth_social_provider_authorize_url_Result'
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/billing.ts:770
  /v1/billing/complimentary:
    post:
      operationId: post_billing_complimentary
      summary: 'Admin only: grant AI Shop without charge until an explicit future end date or…'
      tags:
      - Billing
      security:
      - bearerAuth: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/post_v1_billing_complimentary_Result'
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/billing.ts:770
  /v1/billing/portal:
    post:
      operationId: post_billing_portal
      summary: Open the Stripe customer portal (invoices, payment method, cancellation) once a…
      tags:
      - Billing
      security:
      - bearerAuth: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/get_v1_auth_social_provider_authorize_url_Result'
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '409':
          $ref: '#/components/responses/Error409'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/billing.ts:770
  /v1/billing/stripe-webhook:
    post:
      operationId: post_billing_stripe-webhook
      summary: Stripe webhook for the plans (signature-verified; events without the…
      tags:
      - Billing
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/post_v1_billing_stripe_webhook_Result'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '400':
          description: HTTP 400 failure envelope with stable error codes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '429':
          $ref: '#/components/responses/RateLimited'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
      x-result-schema-source: packages/api/src/routes/billing.ts:770
      x-rate-limits:
      - method: POST
        path: /v1/billing/stripe-webhook
        bucket: billing-webhook
        max: 120
        windowMs: 60000
        identity: client_ip
  /v1/billing/cancellation:
    post:
      operationId: post_billing_cancellation
      summary: Cancel the MeetMyAgent AI Shop or a legacy Business subscription (Verträge hier…
      tags:
      - Billing
      security:
      - bearerAuth: []
      - {}
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/post_v1_billing_cancellation_Result'
        '400':
          $ref: '#/components/responses/Error400'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/kuendigung.ts:675
    get:
      operationId: get_billing_cancellation
      summary: The account's own cancellations to a later day that are still waiting…
      tags:
      - Billing
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/get_v1_billing_cancellation_Result'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/kuendigung.ts:675
  /v1/billing/cancellation/undo:
    post:
      operationId: post_billing_cancellation_undo
      summary: Take a scheduled cancellation back before it takes effect, also one for a later…
      tags:
      - Billing
      security:
      - bearerAuth: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/post_v1_billing_cancellation_undo_Result'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '409':
          $ref: '#/components/responses/Error409'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/kuendigung.ts:675
components:
  schemas:
    post_v1_billing_cancellation_undo_Result:
      type: object
      required:
      - renewsAt
      properties:
        renewsAt:
          anyOf:
          - type: 'null'
          - type: number
      additionalProperties: false
    get_v1_auth_social_provider_authorize_url_Result:
      type: object
      required:
      - url
      properties:
        url:
          type: string
      additionalProperties: false
    get_v1_billing_Result:
      type: object
      required:
      - plan
      - status
      - comp
      - interval
      - currentPeriodEnd
      - cancelAtPeriodEnd
      - limits
      - usage
      - prices
      - offer
      - currentSubscription
      - termsVersion
      - available
      properties:
        compUntil:
          anyOf:
          - type: 'null'
          - type: number
        compExpiring:
          type: boolean
        compNotice:
          anyOf:
          - type: 'null'
          - type: string
        plan:
          anyOf:
          - type: string
            const: free
          - type: string
            const: business
        status:
          anyOf:
          - type: string
            const: none
          - type: string
            const: active
          - type: string
            const: trialing
          - type: string
            const: past_due
          - type: string
            const: unpaid
          - type: string
            const: canceled
          - type: string
            const: incomplete
          - type: string
            const: incomplete_expired
          - type: string
            const: paused
        comp:
          type: boolean
        interval:
          anyOf:
          - type: 'null'
          - type: string
            const: month
          - type: string
            const: year
        currentPeriodEnd:
          anyOf:
          - type: 'null'
          - type: number
        cancelAtPeriodEnd:
          type: boolean
        limits:
          type: object
          required:
          - monthlyAnswers
          - knowledgeSources
          - branding
          - ownerMail
          properties:
            monthlyAnswers:
              type: number
            knowledgeSources:
              type: number
            branding:
              type: boolean
            ownerMail:
              type: boolean
          additionalProperties: false
        usage:
          type: object
          required:
          - answersThisMonth
          - knowledgeSources
          properties:
            answersThisMonth:
              type: number
            knowledgeSources:
              type: number
          additionalProperties: false
        prices:
          type: object
          required:
          - currency
          - businessMonthlyCents
          - businessYearlyCents
          properties:
            currency:
              type: string
              const: eur
            businessMonthlyCents:
              type: number
            businessYearlyCents:
              type: number
          additionalProperties: false
        offer:
          type: object
          required:
          - name
          - currency
          - monthlyCents
          - interval
          - available
          properties:
            name:
              type: string
              const: KI-Shop
              description: AI Shop, the current public plan. The historical wire value is retained for compatibility.
            currency:
              type: string
              const: eur
            monthlyCents:
              type: number
            interval:
              type: string
              const: month
            available:
              type: boolean
          additionalProperties: false
        currentSubscription:
          anyOf:
          - type: 'null'
          - type: object
            required:
            - interval
            - amountCents
            - currency
            properties:
              interval:
                anyOf:
                - type: 'null'
                - type: string
                  const: month
                - type: string
                  const: year
              amountCents:
                type: 'null'
              currency:
                type: 'null'
            additionalProperties: false
        termsVersion:
          type: string
        available:
          type: boolean
      additionalProperties: false
    get_v1_billing_cancellation_Result:
      type: object
      required:
      - scheduled
      properties:
        scheduled:
          type: array
          items:
            type: object
            required:
            - ref
            - receivedAt
            - kind
            - requestedEnd
            properties:
              ref:
                type: string
              receivedAt:
                type: number
              kind:
                anyOf:
                - type: string
                  const: ordinary
                - type: string
                  const: extraordinary
              requestedEnd:
                anyOf:
                - type: object
                  required:
                  - type
                  properties:
                    type:
                      type: string
                      const: next_possible
                  additionalProperties: false
                - type: object
                  required:
                  - type
                  - date
                  properties:
                    type:
                      type: string
                      const: date
                    date:
                      type: string
                  additionalProperties: false
            additionalProperties: false
      additionalProperties: false
    post_v1_billing_cancellation_Result:
      type: object
      required:
      - ref
      - receivedAt
      - receivedAtText
      - declaration
      - confirmEmail
      - account
      - mailSent
      properties:
        ref:
          type: string
        receivedAt:
          type: number
        receivedAtText:
          type: object
          required:
          - date
          - time
          - zone
          properties:
            date:
              type: string
            time:
              type: string
            zone:
              type: string
          additionalProperties: false
        declaration:
          type: object
          required:
          - kind
          - reason
          - name
          - company
          - accountEmail
          - contract
          - requestedEnd
          properties:
            kind:
              anyOf:
              - type: string
                const: ordinary
              - type: string
                const: extraordinary
            reason:
              anyOf:
              - type: 'null'
              - type: string
            name:
              type: string
            company:
              anyOf:
              - type: 'null'
              - type: string
            accountEmail:
              type: string
            contract:
              type: string
            requestedEnd:
              anyOf:
              - type: object
                required:
                - type
                properties:
                  type:
                    type: string
                    const: next_possible
                additionalProperties: false
              - type: object
                required:
                - type
                - date
                properties:
                  type:
                    type: string
                    const: date
                  date:
                    type: string
                additionalProperties: false
          additionalProperties: false
        confirmEmail:
          type: string
        account:
          anyOf:
          - type: 'null'
          - type: object
            required:
            - outcome
            - endAt
            properties:
              outcome:
                anyOf:
                - type: string
                  const: extraordinary
                - type: string
                  const: executed
                - type: string
                  const: scheduled_later
                - type: string
                  const: no_contract
              endAt:
                anyOf:
                - type: 'null'
                - type: number
            additionalProperties: false
        mailSent:
          type: boolean
      additionalProperties: false
    EnvelopeError:
      type: object
      required:
      - code
      - slug
      - message
      - documentation_url
      properties:
        code:
          type: integer
          description: Stable numeric code (never reused).
        slug:
          type: string
          enum:
          - pilot_not_configured
          - pilot_forbidden
          - test_mode_required
          - network_profile_verification_required
          - idempotency_key_required
          - invalid_signature
          - outcome_unknown
          - counterparty_not_allowed
          - limit_exceeded
          - merchant_mismatch
          - policy_unavailable
          - merchant_not_ready
          - payment_mismatch
          - token_unverified
          - provider_unavailable
          - provider_unverified
          - invalid_event
          - idempotency_in_flight
          - commerce_order_not_found
          - auth_required
          - invalid_token
          - insufficient_scope
          - principal_not_verified
          - invalid_credentials
          - email_taken
          - magic_link_invalid
          - magic_link_throttled
          - password_too_weak
          - api_key_not_found
          - scope_not_grantable
          - oauth_invalid_client
          - oauth_invalid_grant
          - oauth_invalid_request
          - oauth_redirect_mismatch
          - oauth_request_not_found
          - social_provider_unavailable
          - social_email_unverified
          - verification_session_required
          - verification_unavailable
          - invalid_request
          - not_found
          - idempotency_key_reused
          - conflict
          - rate_limited
          - agent_not_found
          - principal_not_found
          - setting_not_found
          - setting_invalid_value
          - setting_scope_not_allowed
          - blog_post_not_found
          - blog_slug_conflict
          - token_consumed
          - confirmation_token_invalid
          - confirmation_token_expired
          - confirmation_text_changed
          - hosted_agent_not_found
          - agent_slug_taken
          - agent_slug_invalid
          - agent_not_ready
          - agent_content_rejected
          - knowledge_limit_reached
          - knowledge_source_not_found
          - knowledge_fetch_failed
          - knowledge_login_wall
          - agent_request_not_found
          - agent_slug_locked
          - external_agent_not_found
          - agent_card_unreachable
          - agent_card_invalid
          - agent_card_signature_invalid
          - agent_domain_not_verified
          - external_agent_forbidden
          - directory_entry_not_found
          - remote_agent_failed
          - billing_not_configured
          - already_subscribed
          - billing_customer_missing
          - billing_confirmation_required
          - plan_limit_reached
          - assistant_limit_reached
          - internal
          - not_implemented
          - platform_funnel_unavailable
          description: Stable string code, branch on this.
        message:
          type: string
        documentation_url:
          type: string
          format: uri
    Envelope:
      type: object
      required:
      - success
      - result
      - errors
      - messages
      - request_id
      properties:
        success:
          type: boolean
          const: true
        result:
          description: Endpoint-specific result.
        errors:
          type: array
          maxItems: 0
          items:
            $ref: '#/components/schemas/EnvelopeError'
        messages:
          type: array
          items:
            type: string
        result_info:
          type: object
          description: Present on paginated lists.
          properties:
            cursor:
              type:
              - string
              - 'null'
              description: Opaque cursor for the next page; null when exhausted.
            count:
              type: integer
            per_page:
              type: integer
        links:
          type: array
          description: Next-action links on a single-resource response, chain by following `rel`, never by rebuilding the URL.
          items:
            type: object
            required:
            - rel
            - href
            - method
            properties:
              rel:
                type: string
                description: Stable relation name (self, plus the actions the resource offers).
              href:
                type: string
                format: uri
              method:
                type: string
                enum:
                - GET
                - POST
                - PATCH
                - DELETE
              title:
                type: string
        request_id:
          type: string
          description: Echoes X-Request-Id; quote it in support requests.
    ErrorEnvelope:
      type: object
      required:
      - success
      - result
      - errors
      - messages
      - request_id
      properties:
        success:
          type: boolean
          const: false
        result:
          type: 'null'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/EnvelopeError'
        messages:
          type: array
          items:
            type: string
        request_id:
          type: string
    post_v1_billing_complimentary_Result:
      type: object
      required:
      - principalId
      - comp
      - compUntil
      - autoRenew
      properties:
        principalId:
          type: string
        comp:
          type: boolean
        compUntil:
          anyOf:
          - type: 'null'
          - type: number
        autoRenew:
          type: boolean
          const: false
      additionalProperties: false
    post_v1_billing_stripe_webhook_Result:
      anyOf:
      - type: object
        required:
        - received
        - reason
        properties:
          received:
            type: boolean
            const: false
          reason:
            type: string
        additionalProperties: false
      - type: object
        required:
        - received
        - ignored
        properties:
          received:
            type: boolean
            const: true
          ignored:
            type: string
        additionalProperties: false
      - anyOf:
        - type: object
          required:
          - duplicate
          - ignored
          - received
          properties:
            duplicate:
              type: boolean
            ignored:
              type: string
            applied:
              not: {}
            received:
              type: boolean
              const: true
          additionalProperties: false
        - type: object
          required:
          - duplicate
          - applied
          - received
          properties:
            duplicate:
              type: boolean
            applied:
              type: boolean
            ignored:
              not: {}
            received:
              type: boolean
              const: true
          additionalProperties: false
  responses:
    Error400:
      description: HTTP 400 failure envelope with stable error codes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Error403:
      description: HTTP 403 failure envelope with stable error codes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Error401:
      description: HTTP 401 failure envelope with stable error codes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Error409:
      description: HTTP 409 failure envelope with stable error codes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    RateLimited:
      description: Request budget exceeded. ErrorEnvelope with rate_limited; retry after the fixed window resets.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Error404:
      description: HTTP 404 failure envelope with stable error codes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  headers:
    RateLimit-Limit:
      description: Maximum requests in the budget identified by the active guard. See x-rate-limits for shared and conditional budgets.
      schema:
        type: integer
        minimum: 1
    Retry-After:
      description: Seconds before retrying a refused request; equals RateLimit-Reset on a request-budget 429.
      schema:
        type: integer
        minimum: 1
    RateLimit-Reset:
      description: Seconds until that fixed window resets, rounded up. This is a delay, not a Unix timestamp.
      schema:
        type: integer
        minimum: 0
    RateLimit-Remaining:
      description: Requests left in that budget, clamped to zero.
      schema:
        type: integer
        minimum: 0
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session token, scoped API key, or OAuth access token. Required scopes are listed per endpoint in GET /v1.
x-rate-limit-preflights:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/meetmyagent-io/openapi/meetmyagent-io-billing-api-openapi.yml