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"]
}'
const response = await fetch("https://api.livchat.ai/v1/contacts/check", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
phones: ["5511999999999", "5511888888888"],
}),
});
const { data } = await response.json();
// Filter valid numbers
const validNumbers = data.users.filter(u => u.isInWhatsapp);
import requests
response = requests.post(
"https://api.livchat.ai/v1/contacts/check",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"phones": ["5511999999999", "5511888888888"],
},
)
data = response.json()
valid_numbers = [u for u in data["data"]["users"] if u["isInWhatsapp"]]
{
"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": ""
}
]
}
}
Contacts
Check WhatsApp
Check if phone numbers are registered on WhatsApp
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"]
}'
const response = await fetch("https://api.livchat.ai/v1/contacts/check", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
phones: ["5511999999999", "5511888888888"],
}),
});
const { data } = await response.json();
// Filter valid numbers
const validNumbers = data.users.filter(u => u.isInWhatsapp);
import requests
response = requests.post(
"https://api.livchat.ai/v1/contacts/check",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"phones": ["5511999999999", "5511888888888"],
},
)
data = response.json()
valid_numbers = [u for u in data["data"]["users"] if u["isInWhatsapp"]]
{
"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
string[]
required
Array of phone numbers to check in international format
Response Fields
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"]
}'
const response = await fetch("https://api.livchat.ai/v1/contacts/check", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
phones: ["5511999999999", "5511888888888"],
}),
});
const { data } = await response.json();
// Filter valid numbers
const validNumbers = data.users.filter(u => u.isInWhatsapp);
import requests
response = requests.post(
"https://api.livchat.ai/v1/contacts/check",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"phones": ["5511999999999", "5511888888888"],
},
)
data = response.json()
valid_numbers = [u for u in data["data"]["users"] if u["isInWhatsapp"]]
{
"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.
⌘I