Skip to main content
POST
Batch verification

Overview

Unlike the previous method that individually validates if a number has WhatsApp through a GET request, this API offers batch verification.
Maximum of 50,000 validations per request.
Use this API for form validation. It is not recommended to use this API to verify the number’s existence before sending a message, as Z-API already validates the number’s existence for each message sent.

Attributes

string
required
Your instance ID. Available in the Z-API panel under Instances.
string
required
Your Z-API instance token.

Body

array
required
List of phone numbers in DDI DDD NUMBER format. E.g.: 551199999999

Request Body


Response

200

boolean
Whether the number has WhatsApp
string
Number sent in the request
string
Formatted number per WhatsApp’s response
string
WhatsApp’s unique private identifier (null if exists = false)

405

Make sure you are correctly sending the method specification, that is, verify that you sent POST or GET as specified at the beginning of this topic.

415

If you receive a 415 error, make sure to add the “Content-Type” header to your request, which in most cases is “application/json”.