List campaigns | Talkif Docs

{
  "campaigns": [
    {
      "allowedDays": [
        1
      ],
      "callWindows": [
        {
          "endTime": "17:00",
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "startTime": "09:00",
          "dayOfWeek": 1
        }
      ],
      "concurrentCalls": 5,
      "createdAt": "2026-01-15T10:30:00Z",
      "earliestCallTime": "09:00",
      "flowId": "550e8400-e29b-41d4-a716-446655440000",
      "fromPhoneNumber": "+15551234567",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "latestCallTime": "17:00",
      "name": "January Outreach",
      "progress": {
        "activeCalls": 3,
        "completed": 250,
        "failed": 10,
        "noAnswer": 30,
        "notCalled": 5,
        "pending": 200,
        "percentage": 60,
        "skipped": 5,
        "total": 500
      },
      "providerId": "550e8400-e29b-41d4-a716-446655440000",
      "respectContactTimezone": true,
      "source": "user",
      "status": "draft",
      "completedAt": "2024-01-15T09:30:00Z",
      "description": "string",
      "endAt": "2024-01-15T09:30:00Z",
      "flowName": "Q1 Outreach Script",
      "flowVersion": "string",
      "metrics": null,
      "pauseReason": null,
      "pausedAt": "2024-01-15T09:30:00Z",
      "startAt": "2024-01-15T09:30:00Z",
      "startedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 42
  }
}

Authentication

AuthorizationBearer

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

Query parameters

statusenumOptional

Filter by status

searchstringOptional

Case-insensitive search over name and description

limitlongOptional

Max items to return

offsetintegerOptional>=0Defaults to 0

Items to skip

Response

Campaign list

campaignslist of objects

List of campaigns for the current page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error