Skip to main content
POST
/
v1
/
contacts
/
check
curl -X POST https://api.livchat.ai/v1/contacts/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["5511999999999", "5511888888888"]
  }'

{
  "success": true,
  "code": 200,
  "data": {
    "users": [
      {
        "query": "5511999999999",
        "isInWhatsapp": true,
        "jid": "5511999999999@s.whatsapp.net",
        "verifiedName": "Company Name"
      },
      {
        "query": "5511888888888",
        "isInWhatsapp": false,
        "jid": null,
        "verifiedName": ""
      }
    ]
  }
}
Verify if one or more phone numbers have WhatsApp accounts. Use this before sending messages to avoid errors.

​
Request Body

​
phones
string[]
required
Array of phone numbers to check in international format

​
Response Fields

​
data.users
array
curl -X POST https://api.livchat.ai/v1/contacts/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["5511999999999", "5511888888888"]
  }'

{
  "success": true,
  "code": 200,
  "data": {
    "users": [
      {
        "query": "5511999999999",
        "isInWhatsapp": true,
        "jid": "5511999999999@s.whatsapp.net",
        "verifiedName": "Company Name"
      },
      {
        "query": "5511888888888",
        "isInWhatsapp": false,
        "jid": null,
        "verifiedName": ""
      }
    ]
  }
}
Checking numbers before sending helps you avoid errors and saves API calls.