> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Country Capabilities

> Per-country inventory summary so you can see stock reality before running a search

# 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.

```bash theme={null}
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

```json theme={null}
{
  "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.                                                                                                                                            |

<Note>
  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.
</Note>

Once you've picked a country with stock, run a [number search](/numbers/overview#search-available-numbers) to see individual numbers, then check the [regulatory preview](/numbers/regulatory-preview) for any document requirements before you buy.