List coverage
Returns one summary row per destination country, sorted by country name: the sender types it accepts, whether sender registration is required, two-way support, opt-out rules and whether a sending window applies.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/coverage \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.coverage.list_coverage(
q="united",
region="Northern America",
)
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"countries": [
{
"country": "GB",
"name": "United Kingdom",
"region": "Northern Europe",
"dialCode": "44",
"senders": {
"alphanumeric": {
"local": true,
"international": true
},
"shortCode": {
"local": true,
"international": true
},
"longNumber": {
"local": true,
"international": true
}
},
"registrationRequired": {
"local": true,
"international": true
},
"twoWay": true,
"optOutMandatory": false,
"hasSendWindow": false
},
{
"country": "US",
"name": "United States",
"region": "Northern America",
"dialCode": "1",
"senders": {
"alphanumeric": {
"local": false,
"international": false
},
"shortCode": {
"local": true,
"international": true
},
"longNumber": {
"local": true,
"international": true
}
},
"registrationRequired": {
"local": true,
"international": true
},
"twoWay": true,
"optOutMandatory": true,
"hasSendWindow": false
}
],
"total": 2,
"updatedAt": "2026-10-09T09:49:01Z"
}{
"error": "twoWay must be true or false"
}{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Query Parameters
Search text, case-insensitive. Matches a substring of the country name (united), an exact ISO 3166-1 alpha-2 code (GB) or the start of the dial code (44 or +44); spaces and a leading + are ignored.
Exact region name, case-insensitive, for example Northern America, Western Europe or South-central Asia. Partial names match nothing; read the region values from an unfiltered list to see the full set.
true returns only countries where recipients can reply; false returns the rest, including countries where two-way support is unknown. Also accepts 1/0 and t/f; any other value returns 400 with twoWay must be true or false.
true returns countries that require sender registration for local or international traffic; false returns countries that require neither. Accepts the same values as twoWay; anything else returns 400 with registrationRequired must be true or false.
Response
Coverage rows and the dataset timestamp.
Coverage summary rows for every country that matches your filters.
One summary row per matching country, sorted by country name. Empty array when nothing matches.
Show child attributes
Show child attributes
Number of rows in countries after filtering.
253
When the coverage dataset was last refreshed (ISO 8601).
"2026-10-09T09:49:01Z"
Was this page helpful?
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/coverage \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.coverage.list_coverage(
q="united",
region="Northern America",
)
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"countries": [
{
"country": "GB",
"name": "United Kingdom",
"region": "Northern Europe",
"dialCode": "44",
"senders": {
"alphanumeric": {
"local": true,
"international": true
},
"shortCode": {
"local": true,
"international": true
},
"longNumber": {
"local": true,
"international": true
}
},
"registrationRequired": {
"local": true,
"international": true
},
"twoWay": true,
"optOutMandatory": false,
"hasSendWindow": false
},
{
"country": "US",
"name": "United States",
"region": "Northern America",
"dialCode": "1",
"senders": {
"alphanumeric": {
"local": false,
"international": false
},
"shortCode": {
"local": true,
"international": true
},
"longNumber": {
"local": true,
"international": true
}
},
"registrationRequired": {
"local": true,
"international": true
},
"twoWay": true,
"optOutMandatory": true,
"hasSendWindow": false
}
],
"total": 2,
"updatedAt": "2026-10-09T09:49:01Z"
}{
"error": "twoWay must be true or false"
}{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}