List contact call timeline

{
  "calls": [
    {
      "accountId": "550e8400-e29b-41d4-a716-446655440000",
      "agentStatus": "pending",
      "createdAt": "2026-01-15T10:30:00Z",
      "direction": "inbound",
      "fromNumber": "+15559876543",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "isAnalyzed": true,
      "isRecorded": true,
      "source": "direct",
      "status": "queued",
      "telephonyStatus": "initiating",
      "toNumber": "+15551234567",
      "agentConnectedAt": "2024-01-15T09:30:00Z",
      "agentDisconnectedAt": "2024-01-15T09:30:00Z",
      "botSpeechSecs": 78.2,
      "callSid": "CA1234567890abcdef1234567890abcdef",
      "campaignId": "string",
      "completionTokens": 512,
      "contact": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Jane Smith",
        "company": "Acme Corp",
        "tags": [
          "vip",
          "priority"
        ]
      },
      "cost": "0.053200",
      "dataRetainedAt": "2024-01-15T09:30:00Z",
      "duration": 125,
      "endReason": null,
      "endedAt": "2024-01-15T09:30:00Z",
      "failureCode": null,
      "failureReason": "Recipient did not answer",
      "firstSpeechMs": 1250,
      "flowId": "string",
      "functionCallCount": 3,
      "functionCallTotalMs": 1730,
      "interruptedTurns": 2,
      "isLead": true,
      "promptTokens": 2048,
      "providerType": null,
      "queueInfo": {
        "attemptCount": 0,
        "position": 3,
        "queueId": "550e8400-e29b-41d4-a716-446655440000",
        "queuedAt": "2026-01-15T10:30:00Z",
        "status": "pending",
        "estimatedWaitSeconds": 30
      },
      "recordingDurationSecs": 120.5,
      "recordingExpiresAt": "2024-01-15T09:30:00Z",
      "recordingFileSizeBytes": 1048576,
      "recordingStatus": "ready",
      "recordingStorageCost": "0.000150",
      "scheduleId": "string",
      "startedAt": "2024-01-15T09:30:00Z",
      "triggerDetail": "Spring promo form",
      "ttsCharacters": 3200,
      "turnCount": 12,
      "userSpeechSecs": 45.5,
      "voicemailDetectedAt": "2024-01-15T09:30:00Z",
      "voicemailStatus": "voicemail_detected"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  }
}

Authentication

AuthorizationBearer

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

Path parameters

contactIdstringRequiredformat: "uuid"

Contact ID

Query parameters

limitlongOptional

Max calls (1-100, default 20)

offsetintegerOptional>=0Defaults to 0

Pagination offset

Response

Contact call timeline

callslist of objects

List of call records for the current page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error