Get cost breakdown | Talkif Docs

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "byCategory": [
    {
      "category": "llm_conversation",
      "categoryDisplay": "LLM Conversation",
      "percentage": 32.7,
      "totalMicrocents": 150000000,
      "totalUsd": 15
    }
  ],
  "byFlow": [
    {
      "flowId": "550e8400-e29b-41d4-a716-446655440000",
      "totalMicrocents": 82000000,
      "totalUsd": 8.2,
      "flowName": "string"
    }
  ],
  "calls": [
    {
      "byCategory": [
        {
          "category": "llm_conversation",
          "categoryDisplay": "LLM Conversation",
          "percentage": 32.7,
          "totalMicrocents": 150000000,
          "totalUsd": 15
        }
      ],
      "callId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00Z",
      "totalMicrocents": 5000000,
      "totalUsd": 0.5,
      "contactId": "string",
      "direction": "string",
      "durationSeconds": 1,
      "flowId": "string",
      "flowName": "string"
    }
  ],
  "endDate": "2026-01-16T00:00:00Z",
  "period": "week",
  "startDate": "2026-01-09T00:00:00Z",
  "totalMicrocents": 458000000,
  "totalUsd": 45.8
}

Get account-level cost breakdown by category with drill-down to calls.

Query Parameters

period: today, week, month, or custom (default: week)
startDate: Required when period=custom
endDate: Required when period=custom

Response

Returns total costs, breakdown by category (LLM, STT, TTS, telephony), breakdown by flow, and recent calls with individual cost breakdowns.

Get account-level cost breakdown by category with drill-down to calls. ## Query Parameters - `period`: `today`, `week`, `month`, or `custom` (default: `week`) - `startDate`: Required when `period=custom` - `endDate`: Required when `period=custom` ## Response Returns total costs, breakdown by category (LLM, STT, TTS, telephony), breakdown by flow, and recent calls with individual cost breakdowns.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

periodstringOptional

Time period: today, week, month, or custom

startDatestringOptional

Start date for custom period

endDatestringOptional

End date for custom period

Response

Cost breakdown by category

accountIdstringformat: "uuid"

Account identifier

byCategorylist of objects

Cost breakdown by service category (LLM, TTS, STT, telephony)

byFlowlist of objects

Cost breakdown by flow

callslist of objects

Individual calls with per-category breakdown, for drill-down. Ordered by created_at DESC, limited to the most recent calls in the period.

endDatedatetime

End of the reporting period

periodstring

Time period label

startDatedatetime

Start of the reporting period

totalMicrocentslong

Total cost in microcents (1 cent = 10,000 microcents)

totalUsddouble

Total cost in USD

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error