contacts
Contact management
Get all contacts for a session
Get all contacts for a session
Batch-resolve profile picture URLs for up to 50 contacts
One request for a whole chat sidebar — avoids the burst of parallel single fetches that would exhaust the per-IP throttle. Engine lookups run 5 at a time; per-id failures return null.
List the contacts this account has blocked
The read half of the block/unblock endpoints. A bare array of neutral contact ids — ids only, because that is the honest common subset: whatsapp-web.js resolves full contact models but Baileys' blocklist query answers bare jids, and inventing the other fields on one engine would make the two engines claim different things about the same account.
Get a specific contact by ID
Get a specific contact by ID
Save a contact to the account's addressbook, or edit an existing entry
Save a contact to the account's addressbook, or edit an existing entry
Remove a contact from the account's addressbook
Remove a contact from the account's addressbook
Check if a phone number exists on WhatsApp
Returns whether the number is a registered WhatsApp account and its canonical id. Use this to pre-validate a recipient before sending: the send endpoints return 201 on accepting a message even for numbers that are not on WhatsApp, so this is the only way to confirm a new number is reachable before you send to it.
Get profile picture URL for a contact
Get profile picture URL for a contact
Resolve a contact id (e.g. an @lid) to a phone number — best-effort
Resolve a contact id (e.g. an @lid) to a phone number — best-effort
Block a contact
Block a contact
Unblock a contact
Unblock a contact