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

# Get Contacts

`GET /contacts`

This endpoint retrieves a paginated list of contacts

## Query parameters

- `offset` number — - The offset value for paginating the results - Default 0
- `limit` number — - The maximum number of contacts to retrieve - Default 2000

## Response `200`

200 OK

- object — Note: `chat_ids` associated with a contact are not returned. You can fetch a specific contact by `contact_id` to get all `chat_ids` associated with it
  - `from` number — The starting index of the returned contacts
  - `to` number — The ending index of the returned contacts
  - `count` number — The total count of contacts.
  - `contacts` unknown[] — An array of contact objects. Refer to [the contact object here](/api-reference/objects/the-contact-object)
    - unknown

## Other responses

- `422` — 422 Invalid Limit

---

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