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

# List contacts

`GET /v1/contacts`

Retrieve a paginated list of contacts

## Query parameters

- `limit` integer
- `offset` integer
- `page` integer
- `origin_id` string, uuid
- `name` string
- `ddi` string
- `phone` string
- `email` string
- `tag_ids` string
- `tag_names` string
- `fields` object

## Headers

- `api-token` string, required

## Response `200`

A list of contacts

- object
  - `status` integer — Response status
  - `totalCount` integer — Total items based on current filters
  - `page` integer — Current page
  - `totalPages` integer — Total pages based on current filters
  - `hasNext` boolean — Indicates that has next page
  - `hasPrevious` boolean — Indicates that has previous page
  - `data` Contact[]
    - `id` string, uuid
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `name` string
    - `email` string
    - `organization` string
    - `instagram` string
    - `tags` Tag[]
      - `id` string, uuid
      - `name` string
      - `color` '#f44336' | '#e91e63' | '#9c27b0' | '#673ab7' | '#3f51b5' | '#2196f3' | '#03a9f4' | '#00bcd4' | '#009688' | '#4caf50' | '#8bc34a' | '#faa200' | '#ff9800' | '#ff5722' | '#795548' | '#607d8b'
      - `created_at` string, date-time — Timestamp of when the tag was created
    - `fields` Fields
    - `fullPhone` string

---

[API](https://skmtc.net/clint/apis/clint-api.md) · [All operations](https://skmtc.net/clint/apis/clint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clint/clint-api/revisions/12b8f9eff943/schema)