Get campaign analytics

{
  "attemptDistribution": [
    {
      "attempts": 1,
      "contactCount": 350,
      "percentage": 70
    }
  ],
  "campaignId": "550e8400-e29b-41d4-a716-446655440000",
  "costBreakdown": [
    {
      "category": "llm_conversation",
      "categoryDisplay": "LLM Conversation",
      "percentage": 32.7,
      "totalMicrocents": 150000000,
      "totalUsd": 15
    }
  ],
  "durationBuckets": [
    {
      "bucket": "string",
      "count": 1,
      "percentage": 1.1
    }
  ],
  "failureCauses": [
    {
      "code": "string",
      "count": 1,
      "label": "string",
      "percentage": 1.1,
      "example": "string"
    }
  ],
  "hourlyVolume": [
    {
      "callCount": 15,
      "completed": 12,
      "failed": 2,
      "timestamp": "2026-01-15T09:00:00Z"
    }
  ],
  "outcomes": [
    {
      "count": 320,
      "outcome": "completed",
      "percentage": 64
    }
  ],
  "overview": {
    "avgDurationSeconds": 120,
    "completed": 320,
    "failed": 30,
    "noAnswer": 40,
    "skipped": 10,
    "successRate": 80,
    "totalCalls": 400,
    "totalCost": "45.80",
    "totalDurationSeconds": 48000
  },
  "performance": {
    "callsAnalyzed": 320,
    "conversation": {
      "avgBotSpeechSecs": 68.7,
      "avgInterruptionRate": 0.15,
      "avgTalkRatio": 0.38,
      "avgTurns": 8.5,
      "avgUserSpeechSecs": 42.3
    },
    "latency": {
      "avgFirstSpeechMs": 1150,
      "p50FirstSpeechMs": 980,
      "p95FirstSpeechMs": 2100
    },
    "usage": {
      "totalCompletionTokens": 62000,
      "totalPromptTokens": 245000,
      "totalTtsCharacters": 380000,
      "avgCompletionTokens": 517,
      "avgPromptTokens": 2042,
      "avgTtsCharacters": 3167
    },
    "functionCalls": {
      "avgPerCall": 4,
      "callsWithFunctions": 85,
      "totalCalls": 340,
      "totalDurationMs": 153000,
      "avgDurationMs": 450
    }
  },
  "voicemail": {
    "human": 1,
    "undetermined": 1,
    "voicemail": 1,
    "voicemailRate": 1.1
  }
}

Get deep analytics for a single campaign.

Authentication

AuthorizationBearer

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

Path parameters

campaignIdstringRequiredformat: "uuid"

Campaign ID

Response

Campaign analytics

attemptDistributionlist of objects

Distribution of contacts by attempt count

campaignIdstringformat: "uuid"

Campaign identifier

costBreakdownlist of objects

Cost breakdown by service category

durationBucketslist of objects

Call-duration histogram; an average hides a bimodal distribution.

failureCauseslist of objects

Failures grouped by structured cause, most common first.

hourlyVolumelist of objects

Hourly call volume throughout campaign lifetime

outcomeslist of objects

Contact outcome breakdown with percentages

overviewobject

Overview metrics

performanceobject

Performance metrics (latency, conversation, usage, function calls)

voicemailobject

Answering-machine detection outcomes.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error