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 '{
    "caller_name": "Acme Inc",
    "street_line_1": "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_..."

Number Lifecycle CNAM & Caller ID

⌘I

Getting Started

Channels

AI Agents

Flows

Numbers & Verify

Concepts

Billing

Webhooks

Compliance

Legal

Changelog

Emergency Address (E911)

Emergency Address (E911)

Get the Registered Address

Register or Update the Address

Verify the Address

Record a PSAP/MSAG Confirmation

Remove the Address

​Emergency Address (E911)

​Get the Registered Address

​Register or Update the Address

​Verify the Address

​Record a PSAP/MSAG Confirmation

​Remove the Address

Emergency Address (E911)

Get the Registered Address

Register or Update the Address

Verify the Address

Record a PSAP/MSAG Confirmation

Remove the Address