Skip to content

API referenceEndpoints

Usage

Minutes and calls this billing period.

Usage this billing period

GET/v1/usage

Scopeusage: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)Required

      Start of the billing period (or 30 days ago if there is none).

    • period_endstring (date-time) or nullRequired

      End of the billing period.

    • callsintegerRequired

      Calls this period.

    • minutesintegerRequired

      Minutes this period, rounded up.

    • minutes_includedintegerRequired

      Minutes included.

    • percentintegerRequired

      Share of the included minutes used, 0 to 100.

    • 401authenticationNo access token, or it’s invalid or expired (or, at the token endpoint, wrong client credentials).
    • 403permissionThe token lacks the scope, the IP isn’t allowed, the account isn’t active, or a sandbox key tried to write.
    • 404not_foundNo such object in this account (ids from other accounts are “not found” too).
    • 429rate_limitToo many requests: wait Retry-After seconds.
    • 500serverSomething went wrong on our side. Retry with backoff.

    Errors share one shape. See Errors.

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
}

Try "token", "webhook signature", "rate limit" or "custom domain".