Evolution V2
Check WhatsApp numbers
Checks whether one or more numbers are registered on WhatsApp.
POST
/
chat
/
whatsappNumbers
/
{instance}
Check WhatsApp numbers
curl --request POST \
--url https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance} \
--header 'Content-Type: application/json' \
--header 'apikey: <api-key>' \
--data '
{
"numbers": [
"5511999999999",
"5521988888888"
]
}
'import requests
url = "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}"
payload = { "numbers": ["5511999999999", "5521988888888"] }
headers = {
"apikey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({numbers: ['5511999999999', '5521988888888']})
};
fetch('https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'numbers' => [
'5511999999999',
'5521988888888'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apikey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}"
payload := strings.NewReader("{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apikey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}")
.header("apikey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"jid": "5511999999999@s.whatsapp.net",
"exists": true,
"number": "5511999999999",
"name": "Maria Silva"
},
{
"jid": "5511888888888@s.whatsapp.net",
"exists": false,
"number": "5511888888888"
}
]{
"status": 400,
"error": "Bad Request",
"message": "Invalid payload"
}Authorizations
Your Pilot Status API key (ps_...). Evolution GO also accepts Authorization: Bearer <key>.
Path Parameters
The number's display name in the Pilot Status dashboard.
Body
application/json
Array of numeric phone strings (E.164 without symbols) to verify.
Example:
["5511999999999", "5521988888888"]
Response
Success — provider-native response body.
Resolved WhatsApp JID for the number (user, group or broadcast).
Whether the number is registered on WhatsApp.
The original number as supplied in the request.
Saved contact pushName or group subject, when available.
LID marker/identifier when the JID is a LID (@lid) address.
Was this page helpful?
⌘I
Check WhatsApp numbers
curl --request POST \
--url https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance} \
--header 'Content-Type: application/json' \
--header 'apikey: <api-key>' \
--data '
{
"numbers": [
"5511999999999",
"5521988888888"
]
}
'import requests
url = "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}"
payload = { "numbers": ["5511999999999", "5521988888888"] }
headers = {
"apikey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({numbers: ['5511999999999', '5521988888888']})
};
fetch('https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'numbers' => [
'5511999999999',
'5521988888888'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apikey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}"
payload := strings.NewReader("{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apikey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}")
.header("apikey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://pilotstatus.com.br/api/layer/evolution-v2/chat/whatsappNumbers/{instance}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"numbers\": [\n \"5511999999999\",\n \"5521988888888\"\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"jid": "5511999999999@s.whatsapp.net",
"exists": true,
"number": "5511999999999",
"name": "Maria Silva"
},
{
"jid": "5511888888888@s.whatsapp.net",
"exists": false,
"number": "5511888888888"
}
]{
"status": 400,
"error": "Bad Request",
"message": "Invalid payload"
}