---
title: "Get contacts"
method: GET
path: "/public/v1/contacts"
tags: ["Contact"]
---

# Get contacts

`GET /public/v1/contacts`

List the contacts in your CRM, returned oldest-first by creation date. The response is a page envelope: `data` holds the contacts and `next_page` is a ready-to-call URL for the following page (null on the last page).

This endpoint is eventually consistent — a contact you just created or edited may take up to 1 second to appear or reflect its new values here.

By default only non-deleted contacts are returned; use the `deleted` filter to include or isolate soft-deleted ones. Results are further scoped to your company and to the contacts the authenticated user may see under their team restrictions, so two users at the same company can get different lists.

Required permission: `contacts_permissions_view`.

## Query parameters

- `ids` string[]
- `company_ids` string[]
- `owner_ids` string[]
- `inserted_datetime` string
- `deleted` 'no' | 'include' | 'only'
- `page` string
- `updated_datetime` string
- `custom_data` object

## Response `200`

A list of contacts

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

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