Skip to main content

​
Emergency Address (E911)

Register an emergency (E911 / PSAP) dispatchable address against each provisioned number so an emergency call carries the correct civic location. The address is stored on the number and gated by org ownership — a sibling subaccount sharing your tenant schema can neither read nor mutate another subaccount’s dispatchable location.
Orbit’s outbound 911 posture is block-and-disclaim (see ADR-010). Registering an emergency address records and validates the dispatchable location; it does not by itself enable outbound emergency dialing. Treat E911 as a compliance/record-keeping surface, not a live emergency-calling guarantee.

​
Get the Registered Address

curl "https://api.orbit.devotel.io/api/v1/numbers/num_abc123/emergency-address" \
  -H "X-API-Key: dv_live_sk_..."
Returns { "id": "...", "address": null } when nothing is registered.

​
Register or Update the Address

curl -X PUT https://api.orbit.devotel.io/api/v1/numbers/num_abc123/emergency-address \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "line1": "1 Market St",
    "city": "San Francisco",
    "region": "CA",
    "postal_code": "94105",
    "country": "US"
  }'
Owner/admin only. An invalid address returns 422 VALIDATION_ERROR with field-level details.

​
Verify the Address

curl -X POST https://api.orbit.devotel.io/api/v1/numbers/num_abc123/emergency-address/verify \
  -H "X-API-Key: dv_live_sk_..."
Runs a local structural dispatch-readiness check and returns a validation_status plus any validation_issues.
Verification is deliberately local-only — it does not call any provider address-verification API. Upstream PSAP/MSAG confirmation is recorded separately (below).

​
Record a PSAP/MSAG Confirmation

Ingest the carrier/PSAP MSAG confirmation result to flip the address to dispatchable (confirmed) or invalid (rejected). This records an inbound, out-of-band result — it does not initiate a provider verification call. 
curl -X POST https://api.orbit.devotel.io/api/v1/numbers/num_abc123/emergency-address/psap-confirmation \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "carrier_name",
    "confirmed": true,
    "dispatchable_address_id": "dispatch_xyz"
  }'
Owner/admin only.

​
Remove the Address

curl -X DELETE https://api.orbit.devotel.io/api/v1/numbers/num_abc123/emergency-address \
  -H "X-API-Key: dv_live_sk_..."