Skip to main content
GET
Number with application account?

Overview

This method returns whether a number has an application account or not.
Use this API whenever you want to check if a number has an application account, usually for form validation. Do not use this API if you want to verify 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.

Query Parameters

string
required
Contact phone number in DDI DDD NUMBER format. E.g.: 551199999999

Response

200

boolean
Whether the number has an application account
string
Formatted number per the application’s response
string
The application’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”.