Country Capabilities
Before you run a number search, check what’s actually in stock for a country. The country-capabilities endpoint returns a per-(line type × capability) inventory summary so the buy-numbers picker can show you, for example, that the UK has plenty of local-voice numbers but zero SMS-capable mobiles — before you waste a search.
curl "https://api.orbit.devotel.io/api/v1/numbers/country-capabilities?country=GB" \
-H "X-API-Key: dv_live_sk_..."
Query parameters
| Parameter | Type | Required | Description |
|---|
country | ISO 3166-1 alpha-2 | Yes | Country to summarise (e.g. GB, US). |
Response
{
"data": {
"country": "GB",
"summary": {
"mobile_sms": 100,
"mobile_voice": 100,
"local_sms": 0,
"local_voice": 100,
"toll_free": 42,
"toll_free_sms": 0
},
"two_way_sms": 100,
"us_uses_10dlc": false,
"last_updated": "2026-06-08T10:00:00.000Z"
}
}
Fields
| Field | Description |
|---|
summary.mobile_sms / mobile_voice | Count of mobile numbers with SMS / voice capability. |
summary.local_sms / local_voice | Count of local numbers with SMS / voice capability. local_sms is 0 in countries where landlines don’t carry SMS (UK, DE, FR, …). |
summary.toll_free | Count of toll-free numbers (any capability). |
summary.toll_free_sms | Toll-free numbers advertising SMS — these are send-only (no inbound MO leg). |
two_way_sms | Count across all line types that support two-way SMS (send and receive). This is the authoritative “can this country do two-way SMS” signal — it excludes send-only toll-free. |
us_uses_10dlc | true for the US, where A2P SMS rides 10DLC-registered local numbers. |
local_sms_via_10dlc | Present only when us_uses_10dlc is true: US local numbers eligible for a 10DLC campaign. |
last_updated | ISO timestamp the counts were aggregated. |
Counts are bucketed and clamped at 100 — a value of 100 means “plenty in stock”, not exactly one hundred. The summary is cached server-side for 5 minutes (matching the dashboard’s refetch cadence) and aggregated across carriers; provider names are never surfaced.
