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

# List contacts

`GET /contacts`

Returns the paginated list of contacts for the authenticated user. The top-level "total" field is the number of contacts matching the query filter, independent of skip/limit, so clients can drive server-side pagination.

## Query parameters

- `skip` integer
- `query` string
- `sort_by` 'name' | 'updated_at'
- `sort_descending` boolean
- `limit` integer

## Response `200`

OK

- ResponsesContactsResponse
  - `data` EntitiesContact[], required
    - `created_at` string, required
    - `emails` string[], required
    - `id` string, required
    - `name` string, required
    - `phone_numbers` string[], required
    - `properties` object, required
    - `updated_at` string, required
    - `user_id` string, required
  - `message` string, required
  - `status` string, required
  - `total` integer, required — Total is the number of contacts matching the request filter for the user, independent of the pagination skip/limit applied to Data.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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