List active calls

GET

https://api.talkif.ai/api/v1/calls/active

GET

/api/v1/calls/active

curl https://api.talkif.ai/api/v1/calls/active \
     -H "Authorization: Bearer <token>"

{
  "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
  }
}

Returns the account’s calls that are still live (queued, ringing or in progress), newest first.

Authentication

AuthorizationBearer

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

Query parameters

limitlongOptional

Max items to return (1-100, default 10)

offsetintegerOptional>=0Defaults to 0

Items to skip (default 0)

Response

Paginated list of active calls

callslist of objects

List of call records for the current page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error