Get a number's inbound call/SMS route
Return the inbound routing configuration for one owned DID — how inbound calls (and, when set, inbound SMS) to this number are handled: the route type (e.g. agent, voicemail, ivr, sip_forward, ring_group), its config, any fallback, business-hours gating, caller-ID filtering, and recording override. Returns 404 when no route is configured (treat as the default voicemail behaviour) or when the number is not owned by the caller’s organization. This reads INBOUND handling only; it does not affect outbound calling. Read-only; scoped on the numbers resource (numbers:read or numbers:write). SIP passwords are redacted to ***.
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 Path Parameters
The DID in E.164 (e.g. +14155550100). A leading + is optional — it is added if missing.