---
title: "Get call cost"
method: GET
path: "/v1/call/{callId}/cost"
tags: ["Call"]
---

# Get call cost

`GET /v1/call/{callId}/cost`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/call/{callId}/cost`
- Auth: HTTP bearer

The billable spend attributed to one call, split by cost type, with every cost line behind it. Simulated calls include the costs their simulation incurred before the call connected. Amounts are billable spend only, in exact micro-dollars (`*UsdMicros`) and dollars (`*Usd`, for display). Requires an API key with the `billing:read` permission.

## Path parameters

- `callId` string, uuid, required

## Response `200`

The call’s cost

- object
  - `data` CallCost, required
    - `callId` string, uuid, required
    - `currency` 'usd', required
    - `totalUsdMicros` integer, required: Total billable spend for this call, in micro-dollars.
    - `totalUsd` number, required
    - `breakdown` CostBreakdownItem[], required: Spend by cost type. Sums to totalUsdMicros.
      - `source` 'SIM_PLATFORM_FEE' | 'SIM_TTS' | 'SIM_STT' | 'SIM_LLM' | 'SIM_TELEPHONY' | 'METRIC' | 'TRANSCRIPTION' | 'INTERNAL_LLM' | 'INTERNAL_STT' | 'PHONE_NUMBER', required: The cost source, e.g. SIM_PLATFORM_FEE, SIM_LLM, METRIC.
      - `surface` 'SIMULATION' | 'POST_CALL', required: SIMULATION or POST_CALL.
      - `amountUsdMicros` integer, required: Billable spend for this type, in micro-dollars.
      - `amountUsd` number, required: The same figure in US dollars.
      - `quantity` number, required: Units billed (see the line items for the unit).
    - `items` CallCostLine[], required: Every billable cost line attributed to the call.
      - `eventId` string, required: Stable id of the cost event. Use it to deduplicate.
      - `source` 'SIM_PLATFORM_FEE' | 'SIM_TTS' | 'SIM_STT' | 'SIM_LLM' | 'SIM_TELEPHONY' | 'METRIC' | 'TRANSCRIPTION' | 'INTERNAL_LLM' | 'INTERNAL_STT' | 'PHONE_NUMBER', required
      - `surface` 'SIMULATION' | 'POST_CALL', required
      - `amountUsdMicros` integer, required
      - `amountUsd` number, required
      - `quantity` number, required
      - `quantityUnit` 'MINUTES' | 'INPUT_TOKENS' | 'OUTPUT_TOKENS' | 'CHARACTERS' | 'AUDIO_SECONDS' | 'UNITS', required
      - `provider` string, nullable, required
      - `model` string, nullable, required
      - `simulationJobId` string, uuid, nullable, required
      - `metricDefinitionId` string, uuid, nullable, required: The metric a METRIC line was charged for.
      - `metricCollectionJobId` string, uuid, nullable, required: The grading pass a METRIC line paid for. A call graded twice carries one line per pass.
      - `occurredAt` string, required: When the cost was incurred, ISO 8601.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Call not found
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-10-26** `0fb1c3b1940a`: 2 warning
  - added the new `PHONE_NUMBER` enum value to the `data/breakdown/items/source` response property for the response status `200`
  - added the new `PHONE_NUMBER` enum value to the `data/items/items/source` response property for the response status `200`
- **2026-10-21** `ec9895d783a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/call/:callId/cost/get.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)