Skip to main content
GET
/
sub-accounts
/
all
/
usage
cURL
curl --request GET \
  --url https://api.bolna.ai/sub-accounts/all/usage \
  --header 'Authorization: Bearer <token>'
[
  {
    "from": "2025-09-01T00:00:00",
    "to": "2025-09-25T23:59:59.999999",
    "total_records": 0,
    "total_duration": 0,
    "total_cost": 0,
    "total_platform_cost": 0,
    "total_telephony_cost": 0,
    "status_map": {},
    "synthesizer_cost_map": {},
    "transcriber_cost_map": {},
    "llm_cost_map": {
      "cost": 0,
      "tokens": {}
    },
    "sub_account_id": "5416892b-9052-47d6-92e3-85ac51426903",
    "sub_account_name": "test-one"
  },
  {
    "from": "2025-09-01T00:00:00",
    "to": "2025-09-25T23:59:59.999999",
    "total_records": 7,
    "total_duration": 22,
    "total_cost": 4.864,
    "total_platform_cost": 4,
    "total_telephony_cost": 0.826,
    "status_map": {
      "busy": 5,
      "completed": 2
    },
    "synthesizer_cost_map": {
      "elevenlabs": {
        "eleven_turbo_v2_5": {
          "characters": 129,
          "cost": 0
        }
      }
    },
    "transcriber_cost_map": {
      "deepgram": {
        "nova-2": {
          "duration": 15.199938,
          "cost": 0
        }
      }
    },
    "llm_cost_map": {
      "cost": 0.038,
      "tokens": {
        "gpt-4o-mini": {
          "input": 17,
          "output": 127
        }
      }
    },
    "sub_account_id": "33204bca-0902-4b90-b6d2-6ee0b65e7ef9",
    "sub_account_name": "test-2"
  }
]
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.

A list of usage data objects, with each object providing a breakdown for a single sub-account.

​
from
string<date>

The starting timestamp (in ISO 8601 UTC format) to calculate usage.

​
to
string<date-time>

The ending timestamp (in ISO 8601 UTC format) to calculate usage.

​
total_records
integer

Total numbers of executions.

​
total_duration
number

Total duration in seconds.

​
total_cost
number

Total cumulative cost of executions in cents.

​
total_platform_cost
number

Total cumulative platform cost of executions in cents.

​
total_telephony_cost
number

Total cumulative telephony cost of executions in cents.

​
status_map
object

A map of call status with their counts.

​
synthesizer_cost_map
object
​
transcriber_cost_map
object
​
llm_cost_map
object
​
sub_account_id
string<uuid>

Unique identifier for the sub-account.

​
sub_account_name
string

Human-readable name of the sub-account.

⌘I