Skip to main content
GET
/
sub-accounts
/
{sub_account_id}
/
usage
cURL
curl --request GET \
  --url https://api.bolna.ai/sub-accounts/{sub_account_id}/usage \
  --header 'Authorization: Bearer <token>'
{
  "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.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
sub_account_id
string<uuid>
required

The unique identifier of the sub-account.

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 all usage details for the sub-account

​
from
string<date>

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

Example:

"2025-06-25"

​
to
string<date-time>

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

Example:

"2025-06-27T23:59:59.999999"

​
total_records
integer

Total numbers of executions

Example:

12

​
total_duration
number<float>

Total duration in seconds

Example:

151

​
total_cost
number<float>

Total cumulative cost of executions in cents

Example:

31.754

​
total_platform_cost
number<float>

Total cumulative platform cost of executions in cents

Example:

22

​
total_telephony_cost
number<float>

Total cumulative telephony cost of executions in cents

Example:

2.673

​
status_map
object

A map of call status with their counts. Valid status keys include:

  • queued
  • initiated
  • ringing
  • in-progress
  • call-disconnected
  • completed
  • balance-low
  • busy
  • no-answer
  • canceled
  • failed
  • stopped
  • error
Example:
{ "completed": 11, "no-answer": 1 }
​
synthesizer_cost_map
object
Example:
{
  "elevenlabs": {
    "eleven_turbo_v2_5": { "characters": 577, "cost": 5.77 }
  }
}
​
transcriber_cost_map
object
Example:
{
  "deepgram": {
    "nova-2": { "duration": 125.5993724, "cost": 1.233 }
  }
}
​
llm_cost_map
object