MeetMyAgent Billing API
Plans: Free and AI Shop through Stripe (existing Business subscriptions retain their terms) (plan and usage, checkout, customer portal, webhook)
Plans: Free and AI Shop through Stripe (existing Business subscriptions retain their terms) (plan and usage, checkout, customer portal, webhook)
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/meetmyagent-io:meetmyagent-io-billing-api"
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.
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: 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