Skip to main content
POST
Check availability

Overview

Method used to check the registration availability of a number. This endpoint verifies if the number is available for registration and performs the WhatsApp onboarding setup. It must be called before requesting the confirmation code.
ATTENTIONDo not use this method if you do not have access to the phone where the number is currently linked. This method is useful for speeding up the code confirmation process without having to wait for an SMS or voice call, but it requires you to have the device in hand with the WhatsApp app open.
Banned number scenarioThere are some scenarios where the number is prevented from being connected even on the official WhatsApp app. In this case, the number availability check API is not able to identify this, and the number is only returned as blocked when requesting the code. Unfortunately, there is nothing we can do about this at the moment, because unlike the standard ban, no token (appealToken) is provided to submit an unban request.

Attributes

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

Body

string
required
Country code
string
required
Phone number with area code, no formatting

Request Body


Response

200

boolean
Returns true if the number is available for registration
boolean
Whether the number is banned or blocked for some other reason
string
Token for unban request (when blocked)
number
Time to wait before requesting SMS
number
Time to wait before requesting voice call
number
Time to wait before requesting in-app pop-up
boolean
Whether the pop-up code request method is available
string
In case of error, this attribute states the reason why the error occurred
Available number:
Blocked number:

400

Invalid request. Check if the data you are sending matches the documentation.

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”.