Subscription
Inspect your organization's plan subscription and manage usage-based add-ons like the AI chatbot.
GET
/v1/billing/subscription Get subscription
Retrieve your organization's current subscription, including plan, status, billing cycle, and trial state.
Request
cURL
curl https://api.boltly.online/v1/billing/subscription \
-H "X-API-Key: $API_KEY"Response
JSON
{
"data": {
"id": "7c3d9e5f-...",
"plan_type": "growth",
"status": "active",
"billing_cycle": "monthly",
"current_period_start": "2026-04-01T00:00:00Z",
"current_period_end": "2026-05-01T00:00:00Z",
"cancel_at_period_end": false,
"is_trialing": false,
"days_until_expiry": 28
}
} POST
/v1/billing/addons/chatbot/subscribe Subscribe to chatbot add-on
Enable the AI chatbot add-on for your organization with usage-based billing.
Parameters
billing_unit string required How usage is billed. One of: per_message, per_session.
cost_per_unit number required Cost charged per billing unit.
monthly_fee number Fixed monthly fee for the add-on, if applicable.
Request
cURL
curl -X POST https://api.boltly.online/v1/billing/addons/chatbot/subscribe \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"billing_unit": "per_message",
"cost_per_unit": 0.005,
"monthly_fee": 10
}'Response
JSON
{
"data": {
"id": "2a8f4b6d-...",
"addon_type": "chatbot",
"status": "trialing",
"billing_unit": "per_message",
"cost_per_unit": 0.005,
"monthly_fee": 10,
"trial_units_remaining": 100,
"grace_period_days": 7,
"next_billing_date": "2026-05-01T00:00:00Z",
"activated_at": "2026-04-03T12:00:00Z"
}
} DELETE
/v1/billing/addons/chatbot/subscribe Cancel chatbot add-on
Cancel the chatbot add-on subscription. Usage-based charges stop at the end of the current billing period.
Request
cURL
curl -X DELETE https://api.boltly.online/v1/billing/addons/chatbot/subscribe \
-H "X-API-Key: $API_KEY"Response
JSON
{
"data": {
"id": "2a8f4b6d-...",
"addon_type": "chatbot",
"status": "cancelled"
}
}