Billing API
Access current usage and invoice data for your organization.
Get Current Usage
GET
/billing/usageDescription
Returns the total number of voice minutes consumed in the current billing cycle.
Permissions
Requires Admin role. Managers and Viewers will receive a 403 Forbidden error.
Response
{
"billing_period": {
"start": "2026-07-01T00:00:00Z",
"end": "2026-07-31T23:59:59Z"
},
"minutes_used": 1452,
"minutes_included": 5000,
"overage_minutes": 0,
"estimated_cost_usd": 150.00
}
List Invoices
GET
/billing/invoicesDescription
Returns a list of all historical invoices for the organization.
Permissions
Requires Admin role.
Response
{
"data": [
{
"invoice_id": "inv_8877",
"amount_due_usd": 150.00,
"status": "paid",
"issue_date": "2026-06-01T00:00:00Z",
"pdf_url": "https://billing.kantaswara.com/invoices/inv_8877.pdf"
},
{
"invoice_id": "inv_8876",
"amount_due_usd": 150.00,
"status": "paid",
"issue_date": "2026-05-01T00:00:00Z",
"pdf_url": "https://billing.kantaswara.com/invoices/inv_8876.pdf"
}
]
}