Tracking and Calculating Usage

📘

Usage by workspace

Usage is scoped to individual workspaces. To get usage by workspace, you can call the list endpoint for the related model and sum the usage

Bot usage

How to get a single bot's usage

Bot usage is calculated from the moment the bot triggers the joining_call event until the done or fatal event.

Bots operate on dedicated machines and charges are based on the machine's runtime (not time the bot is recording). There are no separate/additional charges for specific features, though some features may require more compute (e.g. Output Media) and you can choose to use more powerful machines (e.g. 4 core or GPU bots) for smoother bot and recording experiences which come at an extra charge.

Bot usage per workspace

You can use the Get Usage endpoint to retrieve the number of bot hours used within a specific time period for a given workspace.

How to track bot usage for your own customers

You may want to track usage for an individual user or specific organization. For these cases, you can track bot usage with custom metadata

Example

Imagine you want to view all usage from the customer with ID 1234 in October. You can:

1. Create a bot that includes the customer_id in the metadata field.

curl -X POST https://$RECALLAI_REGION.recall.ai/api/v1/bot \
    -H 'Authorization: Token $RECALLAI_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '
    {
      "meeting_url": "$MEETING_URL",
      "metadata": { "customer_id": "1234" }
    }'

2. Call the List Bots endpoint and filter by the customer_id and date range. This will return a paginated list of bots.

curl --request GET \
     --url https://us-east-1.recall.ai/api/v1/bot/?join_at_after=2025-10-01&join_at_before=2025-11-01&metadata__customer_id=1234 \
     --header 'Authorization: $RECALLAI_API_KEY' \
     --header 'accept: application/json'

3. Calculate the usage for each bot and sum up bot usage for all bots returned from the above query.

Transcription Usage

How to get a single recording's transcription usage

There are different ways to get a recording's transcription usage for a given recording depending on what transcription provider you're using