API referenceEndpoints
Usage
Minutes and calls this billing period.
Usage this billing period
GET
/v1/usageScopeusage:read
Calls and minutes since the billing period started (minutes are rounded up per call total).
Partner keys send the client's account id in AssistCall-Account.
Headers
AssistCall-Accountstring (uuid)Partner keys: required. The account id of one of your clients; any other id gets 404. Client keys: optional, and must be the key's own account.
Responses
200Usage.
period_startstring (date-time)RequiredStart of the billing period (or 30 days ago if there is none).
period_endstring (date-time) or nullRequiredEnd of the billing period.
callsintegerRequiredCalls this period.
minutesintegerRequiredMinutes this period, rounded up.
minutes_includedintegerRequiredMinutes included.
percentintegerRequiredShare of the included minutes used, 0 to 100.
- 401
authenticationNo access token, or it’s invalid or expired (or, at the token endpoint, wrong client credentials). - 403
permissionThe token lacks the scope, the IP isn’t allowed, the account isn’t active, or a sandbox key tried to write. - 404
not_foundNo such object in this account (ids from other accounts are “not found” too). - 429
rate_limitToo many requests: wait Retry-After seconds. - 500
serverSomething went wrong on our side. Retry with backoff.
Errors share one shape. See Errors.
- 401
Example request
curl https://api.assistcall.ai/v1/usage \
-H "Authorization: Bearer $ASSISTCALL_TOKEN"Example response (200)
{
"period_start": "2026-10-13T00:00:00.000Z",
"period_end": "2026-11-13T00:00:00.000Z",
"calls": 6,
"minutes": 12,
"minutes_included": 100,
"percent": 12
}