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.
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.
X-API-Key<token>Create in the console: Settings → API & webhooks.
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.
OK
application/json- response
balance*|Wallet balance; null when billing is not enabled on this deployment.
billingEnabled*BillingenabledWhether 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?Successtrue[key: string]?anycurl -X GET 'https://api.callmitra.ai/api/v1/usage'{ "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}Send a WhatsApp message POST
Sends a template, text, media, interactive, location or contacts message to `to` (or `contactId`) from `phoneId` or your default number. Templates can be sent any time; every other type needs the customer to have messaged you in the last 24 hours. A refusal by WhatsApp after the message was created returns 200 with `status: failed` and `error`; a temporary refusal returns 429 or 503 with `Retry-After`, and nothing was delivered.
Check an API key GET
Returns the workspace the request runs in, the key that sent it (access, resources, expiry) and its rate limit. Every key can call this, including read-only keys and keys limited to other resources. With `X-Workspace-Id`, an agency key sees the client workspace.