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

# Get contacts

`GET /contacts`

This method is responsible for returning all of your Whatsapp contacts

## Query parameters

- `count` number
- `offset` number

## Response `200`

OK

- ContactsList
  - `contacts` Contact[]
    - `id` string, required — WA ID
    - `phone` string — Phone number
    - `name` string, required — Contact title from contact book
    - `pushname` string — Account name from WA or WA Business name
    - `is_business` boolean — Is a business account
    - `profile_pic` string — Profile picture URL
    - `profile_pic_full` string — Profile full picture URL
    - `status` string — Contact status
    - `phonebook` boolean — If true, the contact is present in the WhatsApp address book on the primary phone
    - `saved` boolean — Deprecated alias for phonebook
  - `count` integer — Count of requested chats
  - `total` integer — Total number of returned chats
  - `offset` integer — Offset of requested chats

## Other responses

- `400` — Wrong request parameters
- `404` — Specified contact not found
- `500` — Internal Error

---

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