MinglesAI Billing API
The Billing API from MinglesAI — 21 operation(s) for billing.
The Billing API from MinglesAI — 21 operation(s) for billing.
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/mingles-ai:mingles-ai-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: Gonka Proxy Billing API
description: OpenAI-compatible AI proxy with token-based billing
version: 2.0.0
tags:
- name: Billing
paths:
/billing/promo/preview:
post:
summary: Preview Promo Code
description: 'Validate a promo code WITHOUT redeeming it (so the checkout UI can show the
discount and the user can re-check the same code freely).'
operationId: preview_promo_code_billing_promo_preview_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- HTTPBearer: []
tags:
- Billing
/billing/promo/redeem:
post:
summary: Redeem Promo Code
description: Redeem a promo code for the authenticated user (balance / discount / free_sub).
operationId: redeem_promo_code_billing_promo_redeem_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- HTTPBearer: []
tags:
- Billing
/billing/me:
get:
tags:
- Billing
summary: Billing Me
description: Current user's balances, subscriptions, referral, brand.
operationId: billing_me_billing_me_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Billing Me Billing Me Get
security:
- HTTPBearer: []
/billing/models/rates:
get:
tags:
- Billing
summary: Model Rates
description: Public per-model rate card — what the console and docs render.
operationId: model_rates_billing_models_rates_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Model Rates Billing Models Rates Get
/billing/usage:
get:
tags:
- Billing
summary: Billing Usage
description: 'Plan consumption as percentages — the only usage shape we expose publicly.
Three bars (5-hour window, week, billing period) plus a per-model burn rate, and
deliberately no absolute numbers. Token counts and dollar amounts stay server-side
so the limits can be retuned without contradicting something a user was shown; a
percentage of "your plan" survives a retune, "6M tokens" does not.
The burn rate is each model''s price relative to the cheapest one we serve, which
is what the model picker shows next to the name ("×2 — spends your plan twice as
fast"). It falls out of the price table, so a repricing updates it for free.'
operationId: billing_usage_billing_usage_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Billing Usage Billing Usage Get
security:
- HTTPBearer: []
/billing/promo/claim:
post:
tags:
- Billing
summary: Promo Claim
description: 'Apply signup channel + referral bonuses. Idempotent: 200 with reason on retry.'
operationId: promo_claim_billing_promo_claim_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PromoClaimRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Promo Claim Billing Promo Claim Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/pricing:
get:
tags:
- Billing
summary: List Plans
description: 'Public plan list (single USD product — all active plans).
Agency tiers (plan_group == "agency") are excluded by default so they stay
out of the self-serve /app picker; pass ?group=agency to fetch only those.
They remain chargeable by code via /billing/checkout/subscribe regardless.
Internal plans (plan_group == "internal" — the service tier handed to test
accounts) are never listed, whatever group the caller asks for, and every
checkout endpoint refuses them.'
operationId: list_plans_billing_pricing_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response List Plans Billing Pricing Get
/billing/checkout/topup:
post:
tags:
- Billing
summary: Checkout Topup
operationId: checkout_topup_billing_checkout_topup_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TopupRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Topup Billing Checkout Topup Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/checkout/subscribe:
post:
tags:
- Billing
summary: Checkout Subscribe
operationId: checkout_subscribe_billing_checkout_subscribe_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SubscribeRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Subscribe Billing Checkout Subscribe Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/checkout/crypto-topup:
post:
tags:
- Billing
summary: Checkout Crypto Topup
description: 'One-time crypto top-up via NOWPayments (stable-coins). Credits the
prepaid USD inference balance at the confirmed amount.'
operationId: checkout_crypto_topup_billing_checkout_crypto_topup_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CryptoTopupRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Crypto Topup Billing Checkout Crypto Topup Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/checkout/subscribe-from-balance:
post:
tags:
- Billing
summary: Checkout Subscribe From Balance
description: 'Activate a paid plan by debiting the user''s prepaid USD balance.
On insufficient funds, responds 402 with a body the UI can use to deep-link
into the top-up flow (top-up minimum = the shortfall, rounded up to the
nearest $1).'
operationId: checkout_subscribe_from_balance_billing_checkout_subscribe_from_balance_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SubscribeRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Subscribe From Balance Billing Checkout Subscribe From Balance Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/checkout/subscribe-crypto:
post:
tags:
- Billing
summary: Checkout Subscribe Crypto
description: 'Pay a subscription with crypto (NOWPayments invoice). Activates a 30-day
plan period on confirmed IPN. No auto-renewal — user pays again to extend.'
operationId: checkout_subscribe_crypto_billing_checkout_subscribe_crypto_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CryptoSubscribeRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Subscribe Crypto Billing Checkout Subscribe Crypto Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/crypto/currencies:
get:
tags:
- Billing
summary: Crypto Currencies
description: Pay currencies allowed for crypto top-up (stable-coins).
operationId: crypto_currencies_billing_crypto_currencies_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Crypto Currencies Billing Crypto Currencies Get
/billing/platega/quote:
get:
tags:
- Billing
summary: Platega Quote
description: 'USD→RUB estimate (CBR rate + markup) so the wizard can show `≈ ₽…`.
The authoritative ruble amount is fixed at checkout-creation time.'
operationId: platega_quote_billing_platega_quote_get
parameters:
- name: usd
in: query
required: true
schema:
type: number
title: Usd
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Platega Quote Billing Platega Quote Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/billing/checkout/platega-topup:
post:
tags:
- Billing
summary: Checkout Platega Topup
description: 'One-time RUB top-up via Platega (СБП / crypto). Credits the prepaid USD
balance with the full requested amount on confirmation.'
operationId: checkout_platega_topup_billing_checkout_platega_topup_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PlategaTopupRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Platega Topup Billing Checkout Platega Topup Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/checkout/platega-subscribe:
post:
tags:
- Billing
summary: Checkout Platega Subscribe
description: 'Pay a subscription in RUB via Platega. Activates a 30-day period on
confirmation. No auto-renewal — the user pays again to extend.'
operationId: checkout_platega_subscribe_billing_checkout_platega_subscribe_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PlategaSubscribeRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Checkout Platega Subscribe Billing Checkout Platega Subscribe Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/billing/subscription/cancel-renewal:
post:
tags:
- Billing
summary: Cancel Subscription Renewal
description: 'Turn off auto-renewal on the active paid subscription. The user keeps
plan benefits until period_end, then drops to Free automatically.'
operationId: cancel_subscription_renewal_billing_subscription_cancel_renewal_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Cancel Subscription Renewal Billing Subscription Cancel Renewal Post
security:
- HTTPBearer: []
/billing/subscription/resume:
post:
tags:
- Billing
summary: Resume Subscription
description: Reverse a pending cancel-at-period-end so the paid plan renews again.
operationId: resume_subscription_billing_subscription_resume_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Resume Subscription Billing Subscription Resume Post
security:
- HTTPBearer: []
/billing/stripe/webhook:
post:
tags:
- Billing
summary: Stripe Webhook
description: Stripe-signed webhook; verifies HMAC then dispatches via process_event.
operationId: stripe_webhook_billing_stripe_webhook_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/billing/nowpayments/webhook:
post:
tags:
- Billing
summary: Nowpayments Webhook
description: 'NOWPayments IPN. Header: x-nowpayments-sig (HMAC-SHA512 over sorted JSON).'
operationId: nowpayments_webhook_billing_nowpayments_webhook_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/billing/platega/webhook:
post:
tags:
- Billing
summary: Platega Webhook
description: 'Platega status-change callback. Authenticated by the X-MerchantId /
X-Secret headers (no HMAC in Platega''s spec); we constant-time compare them
and re-confirm the status via the API before crediting. Reply 200 within 60s
or Platega retries up to 3× at 5-min intervals.'
operationId: platega_webhook_billing_platega_webhook_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
components:
schemas:
SubscribeRequest:
properties:
plan_code:
type: string
title: Plan Code
description: mini|standard|team
type: object
required:
- plan_code
title: SubscribeRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
PromoClaimRequest:
properties:
signup_channel:
anyOf:
- type: string
- type: 'null'
title: Signup Channel
description: utm_source / channel code
referred_by:
anyOf:
- type: string
- type: 'null'
title: Referred By
description: Inviter referral_code
type: object
title: PromoClaimRequest
PlategaSubscribeRequest:
properties:
plan_code:
type: string
title: Plan Code
description: mini|standard|team
method:
type: integer
title: Method
description: 'Platega paymentMethod: 2=СБП/QR, 13=crypto'
type: object
required:
- plan_code
- method
title: PlategaSubscribeRequest
TopupRequest:
properties:
amount_usd:
type: number
exclusiveMinimum: 0.0
title: Amount Usd
description: Top-up amount in USD
type: object
required:
- amount_usd
title: TopupRequest
PlategaTopupRequest:
properties:
amount_usd:
type: number
exclusiveMinimum: 0.0
title: Amount Usd
description: Credit amount in USD
method:
type: integer
title: Method
description: 'Platega paymentMethod: 2=СБП/QR, 13=crypto'
promo_code:
anyOf:
- type: string
- type: 'null'
title: Promo Code
description: optional promo discount code
type: object
required:
- amount_usd
- method
title: PlategaTopupRequest
CryptoTopupRequest:
properties:
amount_usd:
type: number
exclusiveMinimum: 0.0
title: Amount Usd
description: Credit amount in USD-equivalent
pay_currency:
type: string
title: Pay Currency
description: usdtbsc|usdttrc20|usdcbsc
promo_code:
anyOf:
- type: string
- type: 'null'
title: Promo Code
description: optional promo discount code
type: object
required:
- amount_usd
- pay_currency
title: CryptoTopupRequest
CryptoSubscribeRequest:
properties:
plan_code:
type: string
title: Plan Code
description: mini|standard|team
pay_currency:
type: string
title: Pay Currency
description: usdtbsc|usdttrc20|usdcbsc
type: object
required:
- plan_code
- pay_currency
title: CryptoSubscribeRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer