Vobiz Messaging API - Coverage

The Coverage endpoints describe what each destination country allows for SMS. You use them before your first send to a new country to choose a sender type, check whether registration is needed, and keep content and send times within local rules. The dataset covers more than 250 countries and territories and is the same for every account.

The coverage object

GET /coverage/{country} returns the full record for one country. GET /coverage returns a summary row per country with country, name, region, dialCode, senders, registrationRequired, twoWay, optOutMandatory and hasSendWindow.

Field	Type	Meaning
`country`	string	ISO 3166-1 alpha-2 code, for example `US`.
`name`	string	English name of the country or territory.
`region`	string or `null`	Geographic region, for example `Northern America`.
`dialCode`	string	Country calling code without the `+`.
`mcc`	string or `null`	Mobile country code.
`numberPortability`	boolean or `null`	Whether subscribers can keep their number when they change network.
`localVsInternationalTraffic`	boolean or `null`	`true` when local and international senders follow different rules.
`senders`	object	Accepted sender types: `alphanumeric`, `shortCode`, `longNumber`.
`registration`	object	`required`, plus free-text `durationDays`, `informationRequired`, `documentsRequired`, `alphanumericExtraSteps`.
`urls`	object	Link rules: `allowed` and `whitelistingRequired`.
`optOutMandatory`	boolean or `null`	`true` when messages must offer an opt-out such as STOP.
`twoWay`	boolean or `null`	`true` when recipients can reply.
`prohibitedTopics`	string[]	Content categories that may not be sent, for example `Gambling`.
`prohibitedNotes`	string or `null`	Detail on prohibited or restricted content.
`sendWindow`	object or `null`	Permitted hours: `weekday`, `saturday`, `sunday`. `null` when there is no window.
`marketNotes`	string or `null`	Free-text guidance for the market.
`updatedAt`	string	When the dataset was last refreshed (ISO 8601).

Local and international rules

Rules that can differ by sender origin use a { "local": ..., "international": ... } pair. local applies when you send from a sender in the destination country, and international when you send from abroad. Each value is true, false or null when unknown. This shape is used by every field under senders, registration.required and urls, and by registrationRequired in list rows.

Endpoints

Method	Endpoint	What it does
`GET`	`/coverage`	List a summary row for every country, filtered by name, region, two-way support or registration.
`GET`	`/coverage/{country}`	Retrieve the full coverage record for one country.

Filtering the list

All filters on GET /coverage combine, and the result is sorted by country name with a total count.

Parameter	Matches
`q`	A substring of the country name, an exact ISO code, or the start of the dial code. `united`, `GB` and `+44` all work.
`region`	An exact region name, case-insensitive, for example `Western Europe`.
`twoWay`	`true` for countries where recipients can reply, `false` for the rest.
`registrationRequired`	`true` for countries that require registration for local or international traffic.

The boolean filters accept true/false, 1/0 and t/f. Any other value returns 400, for example twoWay must be true or false. An unknown code on GET /coverage/{country} returns 404 with country not found.

Example

cURL

curl "https://api.vobiz.ai/api/v1/sms/coverage?region=Northern%20America&twoWay=true" \
  -H "X-Auth-ID: MA_XXXXXXXX" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

Response

{
  "countries": [
    {
      "country": "CA",
      "name": "Canada",
      "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
    },
    {
      "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"
}

Using coverage before you send

Pick a sender. Read senders for the destination. Where alphanumeric is false, send from a number; where longNumber.international is false, use a local or short-code sender.
Register first. Where registration.required is true, complete registration before you send. durationDays, informationRequired and documentsRequired tell you what to prepare. For US traffic see US 10DLC and for India see India DLT.
Respect the window. When hasSendWindow is true, read sendWindow and schedule sends inside it. Timezone from MSISDN means the recipient’s local time.
Check content and links. Keep messages clear of prohibitedTopics, and check urls before you include a link.
Offer an opt-out. Where optOutMandatory is true, include STOP instructions and honour opt-outs.

Messaging compliance

Registration paths by country and sender type.

SMS channel

Encoding, segments and sender options for SMS.

Numbers guide

Buy a number for the countries you send to.

Getting Started

API Reference

Guides

Vobiz Messaging API - Coverage

The coverage object

Local and international rules

Endpoints

Filtering the list

Example

Using coverage before you send

Messaging compliance

SMS channel

Numbers guide

India DLT

​The coverage object

​Local and international rules

​Endpoints

​Filtering the list

​Example

​Using coverage before you send

​Related

Messaging compliance

SMS channel

Numbers guide

India DLT

The coverage object

Local and international rules

Endpoints

Filtering the list

Example

Using coverage before you send

Related