Integrating WhatsApp registration checks into your e-commerce or CRM workflow allows you to verify customer contact data in real-time. By confirming whether a phone number is registered on WhatsApp before routing a lead to a support agent or triggering a notification, you can optimize your communication strategy.
This tutorial walks you through performing synchronous registration checks using the WA Lookup API.
Prerequisites
- An active account at WA Lookup.
- An API Key generated from your dashboard settings.
- Phone numbers formatted in E.164 (e.g.,
+1234567890).
Step 1: Choose Your Check Type
The API supports three service types, each providing a different level of detail. All checks are synchronous, meaning the result is returned in the same HTTP response as your request.
-
ws: Confirms basic registration status. -
ws_avatar: Confirms registration and returns avatar availability andavatar_url. -
ws_business: Confirms registration and identifies if the account is a business profile.
Step 2: Secure Your Credentials
Never hardcode your API key in your source code. Use environment variables to manage your credentials securely:
export WA_LOOKUP_API_KEY="your_secret_key_here"
Step 3: Implement the Synchronous Check
To verify a number, send a POST request to /api/v1/check. The API processes the request immediately and returns the result in the response body.
Conceptual Implementation
// Conceptual request payload
{
"service_type": "ws",
"identifier": "+1234567890"
}
Include your API key in the request header:
X-API-Key: <your_key>
Batch Processing
If you need to verify multiple contacts, the API supports submitting a batch of up to 100 identifiers in a single request. The service returns the entire batch result synchronously, eliminating the need for polling or callback mechanisms.
Important Considerations
-
Signal Interpretation: A
registeredresult is a platform-specific reachability signal at the time of the check. It does not prove identity, ownership, consent, or engagement. Always ensure you have obtained necessary consent and respect recipient preferences before initiating contact. - Billing: The service operates on a per-check basis. Failed or undetermined checks are automatically refunded to your balance.
- Concurrency: Consult the official API documentation for details regarding per-user concurrency and timeout behavior.
Conclusion
By integrating synchronous WhatsApp checks, you can ensure your operational workflows—such as lead routing and order verification—rely on current platform status. For advanced AI-driven workflows, you can also leverage the official MCP server, which exposes these same real-time tools to MCP-compatible AI clients using your existing API key.
This article was drafted with AI assistance and reviewed before publishing.
