GET
/
sub-accounts
/
{sub_account_id}
/
usage
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

​
from
string
required

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
required

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

200
application/json

Get all usage details for the sub-account

The response is of type object.