Get all contacts

GET

https://wawp.net/wp-json/awp/v1/contacts/all

Retrieves a list of all known contacts from the connected WhatsApp account's address book and chat history.
This includes individual contacts (JIDs ending in @c.us) and sometimes LID-based identifiers (JIDs ending in @lid), which are used for privacy-aware business interactions.

Developer Tips:

Data Volume: This endpoint can return a large number of contacts.

Pagination: Use the limit and offset parameters to manage large lists efficiently.

Filtering: You can use sortBy and sortOrder to organize the returned list.

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://wawp.net/wp-json/awp/v1/contacts/all?instance_id=123456789&access_token=123456789&limit=50&offset=0&sortBy=name&sortOrder=ASC'

Responses

🟢200Success

application/json

Body

Example

[
    {
        "id": "1234567890@c.us",
        "name": "Alice Smith",
        "pushname": "Alice"
    },
    {
        "id": "9876543210@c.us",
        "name": "",
        "pushname": "Bob"
    },
    {
        "id": "1122334455@lid",
        "name": "",
        "pushname": "Business Contact"
    }
]

Modified at 2026-01-03 02:44:43

Mark chat as unread

Get basic contact info