Minds Billing API

The Billing API from Minds — 3 operation(s) for billing.

GitHub OpenAPI
Business capability
Subscription Billing & Revenue Management BC-4250

Operations 3

GET /api/v1/billing/catalog Read existing Stripe subscription and response-credit options #
POST /api/v1/billing/checkout Start subscription, response-credit or automatic recharge setup checkout #
POST /api/v1/billing/invoices/{invoiceId}/pay Pay an owned, manually collected Stripe invoice with MPP or x402 #

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/getminds:getminds-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. See our Privacy Policy and Terms.

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

OpenAPI Specification

getminds-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Minds Public Billing API
  version: v1
  description: 'OpenAPI 3.1.0 spec for the Minds public API (https://getminds.ai/api/v1 / https://api.getminds.ai/v1). Generate a typed TypeScript client by running an OpenAPI generator (e.g. `openapi-typescript`) against `/_openapi.json`. Auth: send `Authorization: Bearer minds_…_key`; create keys in Settings → API Keys.'
servers:
- url: https://api.getminds.ai
  description: Production (api subdomain)
- url: https://getminds.ai
  description: Production (apex)
security:
- ApiKeyAuth: []
tags:
- name: Billing
paths:
  /api/v1/billing/catalog:
    get:
      responses:
        '200':
          description: Subscription prices, response-credit packs and eligibility.
      operationId: getBillingCatalog
      summary: Read existing Stripe subscription and response-credit options
      tags:
      - Billing
      description: Authenticated catalog from the current billing account, with existing prices and purchase eligibility. Final taxes and discounts are confirmed during Checkout. Use the returned Stripe price IDs to start checkout.
      parameters:
      - name: currency
        in: query
        required: false
        schema:
          type: string
          enum:
          - eur
          - usd
        description: Explicit currency preference shared with UI and MCP. Omit for location-based defaults.
      - name: billingCountry
        in: query
        required: false
        schema:
          type: string
        description: Billing-address country for a new PAYG workspace. Existing billing ownership remains unchanged.
      - name: includeInvoices
        in: query
        required: false
        schema:
          type: boolean
        description: Include recent Stripe invoices for an authorized billing owner or admin. Omitted by default.
  /api/v1/billing/checkout:
    post:
      responses:
        '200':
          description: Stripe Checkout URL and session ID; payment is confirmed through Stripe webhooks.
      operationId: startBillingCheckout
      summary: Start subscription, response-credit or automatic recharge setup checkout
      tags:
      - Billing
      description: Uses existing Stripe prices and billing ownership. Return the URL to the buyer to complete address, tax and payment consent. This does not confirm payment. Send a stable Idempotency-Key for all purchase retries.
      parameters:
      - in: header
        name: Idempotency-Key
        required: true
        schema:
          type: string
          maxLength: 128
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - type: object
                additionalProperties: false
                required:
                - kind
                - legalAcceptance
                properties:
                  kind:
                    const: subscription
                  priceId:
                    type: string
                  planType:
                    enum:
                    - premium
                    - team
                  startTrial:
                    type: boolean
                    description: Legacy field. New Starter subscriptions and trials are retired; true is refused.
                  quantity:
                    type: integer
                    minimum: 1
                  billingCountry:
                    type: string
                  currency:
                    enum:
                    - usd
                    - eur
                  legalAcceptance:
                    type: object
                    required:
                    - termsAccepted
                    - withdrawalConsent
                    additionalProperties: false
                    properties:
                      termsAccepted:
                        const: true
                      withdrawalConsent:
                        const: true
              - type: object
                additionalProperties: false
                required:
                - kind
                - priceId
                properties:
                  kind:
                    const: response_credits
                  priceId:
                    type: string
                  amountMinor:
                    type: integer
                    minimum: 1
                    maximum: 99999999
                    description: Optional custom budget in minor currency units at the responseCredits.customTopUp source price. The server quotes whole responses and charges their rounded total, never unused budget.
                  billingCountry:
                    type: string
                    description: Billing-address country, required for a new PAYG workspace.
              - type: object
                additionalProperties: false
                required:
                - kind
                - priceId
                - amountMinor
                - thresholdAmountMinor
                - monthlyAmountLimit
                properties:
                  kind:
                    const: auto_recharge
                  priceId:
                    type: string
                    description: Current responseCredits.customTopUp source price.
                  amountMinor:
                    type: integer
                    minimum: 1
                    maximum: 99999999
                    description: Custom recharge budget in the source currency, quoted as whole responses.
                  thresholdAmountMinor:
                    type: integer
                    minimum: 0
                    maximum: 99999999
                    description: Low balance threshold converted to whole responses at the same rate; below the recharge amount.
                  monthlyAmountLimit:
                    oneOf:
                    - type: integer
                      minimum: 1
                      maximum: 99999999
                    - const: none
                    description: Automatic purchase cap per UTC calendar month, in the saved currency at the published tax basis. EUR includes VAT; USD excludes added sales tax. Must cover at least one recharge; none requires explicit uncapped consent. Manual purchases are independent.
  /api/v1/billing/invoices/{invoiceId}/pay:
    post:
      responses:
        '200':
          description: Stripe confirmed invoice payment. Fulfillment follows the signed webhook.
        '402':
          description: MPP or x402 payment challenge.
        '409':
          description: Invoice unavailable, changed, or payment needs reconciliation.
      operationId: payBillingInvoice
      summary: Pay an owned, manually collected Stripe invoice with MPP or x402
      tags:
      - Billing
      description: 'Supports open send_invoice invoices for subscriptions and response-credit purchases. Automatic collection stays on Stripe hosted invoices. The 402 challenge quotes the actual remaining amount including tax and discounts. Keep Minds Bearer authentication; send MPP credentials in Payment-Authorization, or x402 in PAYMENT-SIGNATURE. Native MPP clients may instead use Authorization: Payment with Minds-Authorization: Bearer for account identity. x402 requires mppx route-bound nonces and a configured facilitator; USDC is available only for USD invoices. Reuse the original credential after uncertain responses.'
      parameters:
      - name: invoiceId
        in: path
        required: true
        schema:
          type: string
      - in: header
        name: Minds-Authorization
        schema:
          type: string
      - in: header
        name: Payment-Authorization
        schema:
          type: string
      - in: header
        name: PAYMENT-SIGNATURE
        schema:
          type: string
      x-payment-info:
        offers:
        - intent: charge
          method: stripe
          amount: null
          currency: usd
          description: Exact remaining invoice amount; requires a business profile on the owning Stripe account.
        - intent: charge
          method: stripe
          amount: null
          currency: eur
          description: Exact remaining invoice amount; requires a business profile on the owning Stripe account.
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Personal API key. Format: `Bearer minds_…_key`. Create one at https://getminds.ai/settings/api-keys.'