RErecall
billing

Get Usage

Get bot usage in seconds for the authenticated workspace. Each UTC day's usage is treated as occurring at midnight at the start of that day. Both bounds round up to UTC midnight, with exact midnights unchanged, so adjacent ranges do not double-count days. Covered UTC day ranges use workspace-filtered billed usage attributed to bot completion, subject to ingestion delay. Historical ranges and billing-provider failures use the legacy calculation attributed to bot joining. Omitting date parameters includes the workspace's full history.

The base rate limit for this endpoint is:

  • 5 requests per min per workspace
get/api/v1/billing/usage/

Request

  • Base URL
    https://us-east-1.recall.ai
  • URL
    https://us-east-1.recall.ai/api/v1/billing/usage/
  • Auth
    API key in header Authorization

Query parameters

endstring date-time

Exclusive end, rounded up to UTC midnight.

startstring date-time

Inclusive start, rounded up to UTC midnight.

Response

bot_totalnumber double required

Total bot usage in seconds for the authenticated workspace.

Changes

No recorded changes to this operation across all 17 revisions of this API.