Skip to Content
CallMitraDocs
API referenceWorkspace

Get usage and balance

Calls, talk time, billed minutes and wallet charges for a period, plus the current plan period and wallet balance. Defaults to the current billing period (or the last 30 days). `balance` is null when billing is not enabled on the deployment.

GET
/api/v1/usage

Calls, talk time, billed minutes and wallet charges for a period, plus the current plan period and wallet balance. Defaults to the current billing period (or the last 30 days). balance is null when billing is not enabled on the deployment.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Query Parameters

from?|

Start of the period: ISO 8601 date or date-time (UTC if no offset).

to?|

End of the period (exclusive); a bare date includes that whole day. Default now.

Response Body

OK

application/json
  1. response
balance*|

Wallet balance; null when billing is not enabled on this deployment.

billingEnabled*Billingenabled

Whether plan limits and wallet charges apply on this deployment.

calls*
period*
plan*|

Current billing period of the plan this workspace uses (an agency's shared plan for a client workspace it pays for); null without a plan.

success?Success
Defaulttrue
[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/usage'
Example Response
{  "balance": {    "balanceInrPaise": 150000,    "minutesAtCurrentRate": 250,    "ratePerMinuteInrPaise": 600  },  "billingEnabled": true,  "calls": {    "billedMinutes": 402,    "completed": 288,    "durationSeconds": 21950,    "total": 412,    "walletChargedInrPaise": 0  },  "period": {    "basis": "billing_period",    "end": "2026-11-15T12:00:00Z",    "start": "2026-11-01T00:00:00Z"  },  "plan": {    "minutesIncluded": 2000,    "minutesRemaining": 1598,    "minutesUsed": 402,    "name": "Growth",    "overageAmountInrPaise": 0,    "overageMinutes": 0,    "periodEnd": "2026-12-01T00:00:00+00:00",    "periodStart": "2026-11-01T00:00:00+00:00",    "slug": "growth"  },  "success": true}