---
title: "List contacts"
method: GET
path: "/v1/contacts"
tags: ["Contacts"]
---

# List contacts

`GET /v1/contacts`

List and search contacts for a profile. Supports filtering by tags, platform, subscription status, and text search on name, email and company.

## Query parameters

- `profileId` string
- `accountId` string
- `search` string
- `tag` string
- `tags` string
- `platform` 'instagram' | 'facebook' | 'telegram' | 'twitter' | 'bluesky' | 'reddit' | 'whatsapp' | 'slack' | 'sms'
- `isSubscribed` 'true' | 'false'
- `limit` integer
- `skip` integer

## Response `200`

Contacts list with pagination and filter metadata

- object
  - `success` boolean
  - `contacts` object[]
    - `id` string
    - `name` string
    - `email` string
    - `company` string
    - `avatarUrl` string
    - `tags` string[]
    - `isSubscribed` boolean
    - `isBlocked` boolean
    - `lastMessageSentAt` string, date-time
    - `lastMessageReceivedAt` string, date-time
    - `messagesSentCount` integer
    - `messagesReceivedCount` integer
    - `customFields` object
    - `notes` string
    - `createdAt` string, date-time
    - `platform` string
    - `platformIdentifier` string
    - `displayIdentifier` string
  - `filters` object
    - `tags` string[]
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer
    - `hasMore` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

## Changes

- **2026-09-09** `41eff0cffb2d` — 1 info
  - added the new enum value `sms` to the `query` request parameter `platform`
- **2026-09-02** `017dff7e4324` — 1 info
  - added the new enum value `slack` to the `query` request parameter `platform`

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/contacts/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/339f59df69dd?raw)