WhatsApp Presence
The WhatsApp Presence API enables businesses to determine whether a given mobile number is registered on WhatsApp—without triggering any message or notification to the user. Designed for fraud detection, onboarding verification, and communication-channel optimization, this API provides a fast and compliant way to check WhatsApp footprint for any valid phone number.
WhatsApp has one of the highest penetration rates across demographics, making it a strong signal for number legitimacy, activity, and reliability. This API empowers risk teams, onboarding flows, and messaging systems to perform intelligent routing and verification in real-time.
Key Features
1. WhatsApp Registration Detection
Instantly checks if a mobile number is associated with a WhatsApp account.
2. Business Account Identification
Returns whether the registered WhatsApp account is a personal or business profile.
3. No User Disturbance
The check is silent—no OTP, message, or alert goes to the user.
4. Low Latency & High Accuracy
Optimized for large-scale risk, onboarding, and messaging use cases.
API Details
curl --location 'https://api-preproduction.signzy.app/api/v3/phone-to-whatsapp-check' \
--header 'Authorization: <auth token>' \
--header 'Content-Type: application/json' \
--data '{
"mobile": "<Phone number>"
}'Request Body Parameters
Parameter | Type | Description | Mandatory/Optional |
|---|---|---|---|
mobile | String | Phone Number of the Individual | Mandatory |
Success Response
{
"result": {
"status": "Account Found",
"isBusiness": "false"
},
"reason": "Request Successful",
"code": "S001"
}Response Body Parameters
Parameter | Type | Description |
|---|---|---|
status | String | It indicates whether an account exists for the phone number provided. Possible values:"Account Found","Account Not Found" |
isBusiness | String | It specifies whether it is a business account or not. Possible values:"true", "false" ,"" |
Code Samples
{
"result": {},
"reason": "Internal Server Error",
"code": "E601"
}Error Codes
HTTP Status Code | Error Code | Description |
|---|---|---|
400 | E001 | Bad Request |
401 | E1001 | Unauthorized Access |
403 | E201 | Forbidden |
404 | E301 | Data Not Found |
409 | E401 | Upstream error |
429 | E501 | Rate Limit Exceeded |
500 | E601 | Internal Server Error |
503 | E701 | Service Unavailable |
504 | E801 | Timeout |
Conclusion
The WhatsApp Presence API is a crucial enabler for fraud prevention, onboarding verification, and intelligent communication routing. By leveraging WhatsApp's high penetration footprint, the API offers a strong contextual signal about the legitimacy and activity of a mobile number—without requiring user interaction or OTP flows.
With standardized responses, robust error handling, and low latency, it fits seamlessly into enterprise workflows across KYC, risk scoring, and messaging optimization.