List schedules | Talkif Docs

{
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 42
  },
  "schedules": [
    {
      "contactId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00Z",
      "flowId": "550e8400-e29b-41d4-a716-446655440000",
      "frequency": "once",
      "fromPhoneNumber": "+15551234567",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "maxRetries": 2,
      "name": "Daily Follow-up Call",
      "providerId": "550e8400-e29b-41d4-a716-446655440000",
      "retryDelayMinutes": 30,
      "retryOnFailure": true,
      "runCount": 5,
      "scheduleTime": "09:00",
      "status": "active",
      "timezone": "America/New_York",
      "cronExpression": "string",
      "dayOfMonth": 1,
      "daysOfWeek": [
        1
      ],
      "endDate": "2023-01-15",
      "flowVersion": "string",
      "lastRunAt": "2024-01-15T09:30:00Z",
      "maxRuns": 1,
      "nextRunAt": "2024-01-15T09:30:00Z"
    }
  ]
}

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

Allowed values:

limitlongOptional

Max items to return

offsetintegerOptional>=0Defaults to 0

Items to skip

Response

Schedule list

metaobject

Pagination metadata

scheduleslist of objects

List of schedules for the current page

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error