List contacts | Talkif Docs

{
  "contacts": [
    {
      "accountId": "550e8400-e29b-41d4-a716-446655440000",
      "address": {},
      "createdAt": "2026-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "interests": [
        "healthcare",
        "scheduling"
      ],
      "language": "en",
      "name": "Jane Smith",
      "primaryPhone": "+15551234567",
      "secondaryPhones": [
        "+15559876543",
        "+15558765432"
      ],
      "tags": [
        "vip",
        "priority"
      ],
      "updatedAt": "2026-01-15T10:30:00Z",
      "company": "Acme Corp",
      "deletedAt": "2024-01-15T09:30:00Z",
      "email": "jane@example.com",
      "lastContactedAt": "2024-01-15T09:30:00Z",
      "notes": "string",
      "occupation": "Product Manager",
      "timezone": "America/New_York"
    }
  ],
  "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.

Query parameters

limitlongOptional

Max items to return (1-100)

offsetintegerOptional>=0Defaults to 0

Items to skip

searchstringOptional

Search by name, phone, or email

tagstringOptional

Filter by single tag (deprecated, use tags)

tagsstringOptional

Comma-separated tags to filter by

tagModestringOptional

Tag match mode: ‘any’ (OR) or ‘all’ (AND)

companystringOptional

Filter by company

includeDeletedbooleanOptional

Include soft-deleted contacts

Response

Contact list with pagination

contactslist of objects

List of contacts matching the query

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error