GET
/
sub-accounts
/
all
/
usage
cURL
curl --request GET \
  --url https://api.bolna.ai/sub-accounts/all/usage \
  --header 'Authorization: Bearer <token>'
{
  "sub_account_id": "019f3f5d-fda1-427c-b1f8-0ac9b6731a4c",
  "sub_account_name": "alpha-sub-account",
  "from": "2025-06-25",
  "to": "2025-06-27T23:59:59.999999",
  "total_records": 12,
  "total_duration": 151,
  "total_cost": 31.754,
  "total_platform_cost": 22,
  "total_telephony_cost": 2.673,
  "status_map": {
    "completed": 11,
    "no-answer": 1
  },
  "synthesizer_cost_map": {
    "elevenlabs": {
      "eleven_turbo_v2_5": {
        "characters": 577,
        "cost": 5.77
      }
    }
  },
  "transcriber_cost_map": {
    "deepgram": {
      "nova-2": {
        "duration": 125.5993724,
        "cost": 1.233
      }
    }
  },
  "llm_cost_map": {
    "cost": 0.078,
    "tokens": {
      "gpt-4o-mini": {
        "input": 2698,
        "output": 605
      }
    }
  }
}
This is an enterprise feature.You can read more about our enterprise offering here Bolna enterprise.

​
Summary

This endpoint returns aggregated usage data for all sub-accounts associated with the authenticated user’s organization.
It provides fine-grained insight into usage, consumption, and cost breakdowns for each sub-account.

​
Endpoint

GET /sub-accounts/all/usage

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
from
string<date-time>

The start timestamp (in ISO 8601 UTC format) from which to calculate usage. If not provided, the start of the current month (UTC) is used by default.

​
to
string<date-time>

The end timestamp in ISO 8601 UTC format up to which usage is calculated. If not provided, the end of the current date (in UTC) will be used.

Response

Get usage details for all sub-accounts, including cost breakdown.

The response is of type object.