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

# List contacts

`GET /contact/contacts`

Returns a paginated list of contacts.

## Query parameters

- `page` integer
- `limit` integer
- `includeTotal` boolean
- `filter.tags` string
- `filter.countryCode` string
- `filter.phoneNumber` string
- `filter.email` string

## Response `200`

Successfully retrieved a paginated list of objects.

- ContactPage — Represents a given page of items.
  - `offset` integer, required — The position of the item this page starts from, zero-based. e.g., the 11th item is at offset 10.
  - `limit` integer, required — A limit on the number of items to be returned, between 1 and 100, defaults to 10.
  - `length` integer, required — The actual number of items in the page.
  - `total` integer — The total number of items. This field is returned only when the request parameter `includeTotal` is set to `true`.
  - `items` object[]

---

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