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

# List contacts

`GET /v1/contacts`

Retrieve a list of contacts for a company

## Query parameters

- `company_id` integer, required
- `page` integer
- `size` integer
- `dir` 'asc' | 'desc'

## Response `200`

Success

- object
  - `data` object[]
    - `id` string
    - `number` string
    - `name` string, nullable
    - `email` string, nullable
    - `address1` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
    - `city` string, nullable
    - `notes` string, nullable
    - `custom` object, nullable
    - `is_unsubscribed` boolean, nullable
  - `meta` object
    - `pagination` object
      - `total` integer
      - `count` integer
      - `per_page` integer
      - `current_page` integer
      - `total_pages` integer

## Other responses

- `422` — Validation error

---

[API](https://skmtc.dev/800/apis/public-api.md) · [All operations](https://skmtc.dev/800/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/800/public-api/revisions/aab9efc97342/schema)