Per-country capability + stock summary
Per-(line_type × capability) inventory summary for a single country so a buyer can see the stock reality (e.g. GB has plenty of local-voice numbers but 0 SMS-capable mobiles) BEFORE running /numbers/available. Counts are bucketed and clamped at 100 (100 means ‘plenty’, not exactly one hundred), aggregated across carriers (provider names are never surfaced), and cached server-side for 5 minutes. Pre-purchase discovery read; scoped on numbers:read.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Query Parameters
ISO 3166-1 alpha-2 country code to summarise (e.g. GB, US). Required — a missing/invalid value returns a 422 envelope from the handler.