v1

latestOpenAPI 3.0.32026-07-26870417.2 KB

contacts

Check Contact Exists

This endpoint checks if contacts exist on WhatsApp

post/contacts/check

Headers

x-phonestring

Example:{{orgPhone}}

Please provide the number of the phone you want to call with this API in the header. The number must be in country code + number format without any characters or spaces, e.g. 919876543210; Alternatively, provide the phone_id (phone-xxxxxxxxxxxx) in the header

Request body

contact_idsstring[] required

Array of contact IDs to check. Must be formatted as country_code + number (e.g., 918527184400). It should be a non-empty array

Example request

{
  "contact_ids": [
    "919537851844",
    "919876543210"
  ]
}

Response

200 OK

contact_idstring

The contact_id of the contact

existsboolean

Whether the contact exists on WhatsApp

Example response

[
  {
    "contact_id": "919537851844",
    "exists": true
  }
]