Number lookup
Look up numbers
Checks up to 100 numbers against the mobile network without messaging them. Returns validity, country, network, porting and roaming for each number.
POST
/
api
/
v1
/
Account
/
{auth_id}
/
Sms
/
Lookup
/
Look up numbers
curl --request POST \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/ \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"numbers": [
"+14155550123",
"12345"
]
}
'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/"
payload = { "numbers": ["+14155550123", "12345"] }
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({numbers: ['+14155550123', '12345']})
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"results": [
{
"input": "+14155550123",
"number": "+14155550123",
"valid": false,
"status": {
"group": "REJECTED",
"name": "REJECTED_ROUTE_NOT_AVAILABLE",
"description": "Route not available"
},
"error": null,
"country": {
"iso": "US",
"name": "United States",
"dialCode": "1"
},
"network": null,
"originalNetwork": null,
"ported": false,
"portedNetwork": null,
"roaming": false,
"roamingNetwork": null,
"cached": false,
"checkedAt": "2026-10-12T10:30:00Z"
},
{
"input": "12345",
"number": "",
"valid": false,
"reason": "too short",
"status": null,
"error": null,
"country": null,
"network": null,
"originalNetwork": null,
"ported": false,
"portedNetwork": null,
"roaming": false,
"roamingNetwork": null,
"cached": false,
"checkedAt": "2026-10-12T10:30:00Z"
}
]
}Authorizations
Path Parameters
Body
application/json
Numbers to check against the mobile network.
Numbers to check, in E.164 format (+14155550123) or national format read with defaultCountry. At most 100 per request. A missing or empty array returns 400 with numbers is required; more than 100 returns 422 with too many numbers: at most 100 per request. Duplicates (the same E.164 number, or the same invalid text) are checked once.
Required array length:
1 - 100 elementsExample:
["+14155550123", "(415) 555-0124"]
ISO 3166-1 alpha-2 country code, matched case-insensitively, used to read numbers written without a + country code. Defaults to US. A code outside the list returns 422 with unsupported defaultCountry.
Available options:
US, CA, GB, IN, AU, NZ, IE, DE, FR, ES, IT, NL, BE, CH, AT, SE, NO, DK, FI, PL, PT, BR, MX, AR, CO, CL, SG, MY, ID, PH, TH, VN, JP, KR, CN, HK, AE, SA, QA, IL, TR, ZA, NG, KE, EG, PK, BD, LK, NP Was this page helpful?
⌘I
Look up numbers
curl --request POST \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/ \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"numbers": [
"+14155550123",
"12345"
]
}
'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/"
payload = { "numbers": ["+14155550123", "12345"] }
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({numbers: ['+14155550123', '12345']})
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms/Lookup/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"results": [
{
"input": "+14155550123",
"number": "+14155550123",
"valid": false,
"status": {
"group": "REJECTED",
"name": "REJECTED_ROUTE_NOT_AVAILABLE",
"description": "Route not available"
},
"error": null,
"country": {
"iso": "US",
"name": "United States",
"dialCode": "1"
},
"network": null,
"originalNetwork": null,
"ported": false,
"portedNetwork": null,
"roaming": false,
"roamingNetwork": null,
"cached": false,
"checkedAt": "2026-10-12T10:30:00Z"
},
{
"input": "12345",
"number": "",
"valid": false,
"reason": "too short",
"status": null,
"error": null,
"country": null,
"network": null,
"originalNetwork": null,
"ported": false,
"portedNetwork": null,
"roaming": false,
"roamingNetwork": null,
"cached": false,
"checkedAt": "2026-10-12T10:30:00Z"
}
]
}