API by router
Billing
Get Billing
Return current plan + usage for the billing page.
"I'll be back." — T-800, The Terminator (to check your billing)
AuthorizationBearer <token>
In: header
Response Body
curl -X GET "https://loading/v1/billing"{
"plan": {
"api_call_limit": 10000,
"billing_cycle": "string",
"conversation_limit": 1000,
"current_period_end": "string",
"current_period_start": "string",
"instance_limit": 1,
"max_sites_per_node": 25,
"plan_name": "string",
"price_cents": 0,
"product_name": "string",
"status": "string",
"tier_id": "string",
"tier_slug": "string",
"token_allowance": 100000,
"trial_days_remaining": 0,
"trial_ends_at": "string"
},
"subscribed_tier_ids": [],
"usage": {
"active_instances": 0,
"api_call_limit": 10000,
"conversation_limit": 1000,
"instance_limit": 0,
"max_sites_per_node": 25,
"platform_cost_usd": "string",
"token_allowance": 100000,
"total_cost_usd": "string",
"total_hosted_sites": 0,
"total_requests": 0,
"total_tokens": 0,
"unique_end_users": 0,
"webhost_nodes": 0
}
}Get Trial Status
Fast trial status check — just subscription + trial dates.
"I've seen things you people wouldn't believe..." — Roy Batty, Blade Runner (about expired trials)
AuthorizationBearer <token>
In: header
Response Body
curl -X GET "https://loading/v1/billing/trial-status"{
"plan_name": "No Plan",
"status": "string",
"trial_days_remaining": 0,
"trial_ends_at": "string",
"trial_expired": false,
"upgrade_url": "/billing"
}Get Usage
Detailed usage breakdown with per-instance split and allowance tracking.
"I'm not bad. I'm just drawn that way." — Jessica Rabbit (about token consumption patterns)
AuthorizationBearer <token>
In: header
Response Body
curl -X GET "https://loading/v1/billing/usage"{
"by_instance": [
{}
],
"period_end": "string",
"period_start": "string",
"platform_cost_usd": "string",
"token_allowance_monthly": 0,
"token_usage_pct": 0,
"total_cost_usd": "string",
"total_requests": 0,
"total_tokens": 0,
"unique_end_users": 0
}Get Usage Chart
Daily usage time series, optionally filtered to a single instance.
"Where we're going, we don't need roads." — Doc Brown (about charting token usage into the future)
AuthorizationBearer <token>
In: header
Query Parameters
days?Days
Default
30instance_id?Instance Id
Response Body
curl -X GET "https://loading/v1/billing/usage/chart?days=30&instance_id=string"{
"period_label": "string",
"points": [
{
"cost_usd": "string",
"date": "string",
"requests": 0,
"tokens": 0
}
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}