List flows | Talkif Docs

{
  "flows": [
    {
      "accountId": "550e8400-e29b-41d4-a716-446655440000",
      "analysisOverride": "use_account_default",
      "connectedPhones": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "phoneNumber": "+15551234567",
          "friendlyName": "Main Office Line"
        }
      ],
      "createdAt": "2026-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Appointment Reminder",
      "nodeCount": 5,
      "recordingOverride": "use_account_default",
      "status": "DRAFT",
      "tags": [
        "healthcare",
        "scheduling"
      ],
      "updatedAt": "2026-01-20T14:00:00Z",
      "version": "1.2.0",
      "versions": [
        {
          "publishedAt": "2026-01-15T10:30:00Z",
          "version": "1.2.0",
          "notes": "string"
        }
      ],
      "voicemailEnabled": true,
      "description": "Automated appointment reminder calls",
      "publishedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  }
}

GET /api/v1/flows

Returns lightweight flow list with connected phones.

Authentication

AuthorizationBearer

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

Query parameters

limitintegerOptional>=0

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

offsetintegerOptional>=0Defaults to 0

Items to skip (default 0)

Response

Paginated list of flows with connected phone numbers

flowslist of objects

Items on this page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error