Workspace

Billing

Read your subscription and usage, and start a checkout or credit top-up. Amounts are in INR; usage cost is metered in USD.

Two plan systems: POST /billing/checkout uses Stripe tiers (starter | pro), while the INR plan catalog returned by /billing/config (starter / growth / scale) is for Razorpay credit top-ups.

GET/billing/subscription billing:read

Get subscription

The current subscription (or null on the free plan).

bash

curl https://api.bolchoai.in/v1/billing/subscription \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "tier": "free", "status": "active", "includedMinutes": 60, "currentPeriodEnd": null }

GET/billing/usage billing:read

Get usage

Usage for a billing period, grouped by metric.

Query parameters

period

string

Billing period YYYY-MM (default current month).

bash

curl https://api.bolchoai.in/v1/billing/usage \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "period": "2026-07", "includedMinutes": 60, "metrics": [ { "metric": "call_minutes", "quantity": 128, "costUsd": 3.2 } ], "totalCostUsd": 3.2 }

GET/billing/config billing:read

Get billing config

Plans, INR rate, credit balance, and whether Razorpay is enabled.

bash

curl https://api.bolchoai.in/v1/billing/config \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "currency": "INR", "usdToInr": 86, "creditsUsd": 12.4, "creditsInr": 1066, "plans": [ { "id": "growth", "label": "Growth", "priceInr": 4999 } ], "topupMinInr": 500, "razorpayEnabled": true }

POST/billing/checkout billing:write

Create checkout

Start a Stripe Checkout session for a plan.

Body

tier*

enum

starter | pro.

bash

curl -X POST https://api.bolchoai.in/v1/billing/checkout \
  -H "Authorization: Bearer $BOLCHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tier": "string"
}'

Response

json

{ "url": "https://checkout.stripe.com/…" }

POST/billing/topup billing:write

Top up credits

Create a Razorpay order to add prepaid credit or buy a plan (min ₹500).

Body

amountInr*	number	Rupee amount (min 500).
planId	string	Set when buying a plan; defaults to an ad-hoc top-up.

bash

curl -X POST https://api.bolchoai.in/v1/billing/topup \
  -H "Authorization: Bearer $BOLCHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountInr": 123,
  "planId": "string"
}'

Response

json

{ "orderId": "order_…", "amount": 50000, "currency": "INR", "keyId": "rzp_…" }