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.

Once you’ve picked a country with stock, run a number search to see individual numbers, then check the regulatory preview for any document requirements before you buy.

Inventory & Export Regulatory Preview

⌘I

Getting Started

Channels

AI Agents

Flows

Numbers & Verify

Concepts

Billing

Webhooks

Compliance

Legal

Changelog

Country Capabilities

Country Capabilities

Query parameters

Response

Fields

​Country Capabilities

​Query parameters

​Response

​Fields

Country Capabilities

Query parameters

Response

Fields