> ## 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. # Set the emergency (E911) address for a number > Register or replace the E911 dispatchable civic address on a number so an emergency call from it can be routed to the correct PSAP. Saving resets the address to an unverified state, so call the verify endpoint afterwards to run the local dispatch-readiness check. ## OpenAPI ````yaml /openapi.yaml put /api/v1/numbers/{id}/emergency-address openapi: 3.1.0 info: title: Devotel CPaaS API description: Orbit by Devotel — Communications Platform as a Service API version: 1.0.0 contact: name: Devotel url: https://devotel.io email: support@devotel.io license: name: Proprietary servers: - url: https://api.orbit.devotel.io description: Production security: - Bearer: [] - ApiKey: [] tags: - name: Messages description: >- Send and manage messages across all channels (SMS, WhatsApp, RCS, Email, Viber, etc.) - name: Fax description: >- List and track fax (MMS/T.38) transmissions on Telnyx-backed fax numbers (sending flows through the Messaging API) - name: Agents description: AI agent creation, configuration, and execution - name: Voice description: Voice calls, IVR, conferencing, and SIP trunking - name: OnCall description: On-call rotations and escalation policy planning for incident alerting - name: Webhooks description: Webhook endpoint management and delivery logs - name: Numbers description: Phone number search, provisioning, and configuration - name: Brand Identity description: >- Unified cross-channel brand trust posture (10DLC, toll-free, WhatsApp, RCS, branded calling, number KYC) - name: Contacts description: Contact management, segmentation, and lifecycle tracking - name: Campaigns description: Marketing campaign orchestration and analytics - name: Flows description: Automation flow builder and execution engine - name: Templates description: Message template management and approval workflows - name: Settings description: Organization, channel, and user preference settings - name: Verify description: OTP generation and verification across channels - name: Push description: Push notification delivery via FCM and APNs - name: Integrations description: Third-party service connections and OAuth management - name: CDP description: >- Customer Data Platform — activation surface (CRM object sync, streaming destinations, ad-audience activation) - name: Files description: >- Server-to-server media upload, listing, retrieval, and deletion (signed-URL backed) - name: Commerce description: >- Omnichannel conversational-commerce — persistent cart + checkout state machine, channel-agnostic hosted pay-by-link, native WhatsApp checkout, and AP2-style agent payment mandates. - name: Sync description: >- Real-time shared-state primitive (Twilio Sync parity) — Documents, Maps, Lists, and ephemeral Streams, with change events relayed over the /api/v1/ws/sync WebSocket gateway - name: Risk description: >- Unified cross-channel Trust & Fraud risk scoring — fuses SMS-pumping, URL-reputation, Verify Fraud Guard, and Voice Biometrics signals into one composite verdict queryable before a send or a call. - name: Orby description: >- In-dashboard Orby operator assistant: streamed assistant turns, conversation threads, product knowledge-base search, and the tool-action approval gate. Available to signed-in operators only (dashboard session auth — API-key requests are rejected). paths: /api/v1/numbers/{id}/emergency-address: put: tags: - Numbers summary: Set the emergency (E911) address for a number description: >- Register or replace the E911 dispatchable civic address on a number so an emergency call from it can be routed to the correct PSAP. Saving resets the address to an unverified state, so call the verify endpoint afterwards to run the local dispatch-readiness check. parameters: - schema: type: string in: path name: id required: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NumberEmergencyAddressInput' example: caller_name: Jane Operator street_line_1: 1600 Amphitheatre Pkwy street_line_2: Suite 200 city: Mountain View region: CA postal_code: '94043' country: US responses: '200': description: The persisted emergency address content: application/json: schema: type: object properties: data: type: object properties: id: type: string address: $ref: '#/components/schemas/NumberEmergencyAddress' meta: $ref: '#/components/schemas/ResponseMeta' components: schemas: NumberEmergencyAddressInput: type: object description: >- Operator-supplied E911 dispatchable civic address for a number. All fields are required except `street_line_2`; `country` is an ISO-3166 alpha-2 code. required: - caller_name - street_line_1 - city - region - postal_code - country properties: caller_name: type: string description: Name of the person / entity at the dispatchable location. street_line_1: type: string description: House number and street. street_line_2: type: string description: Apartment / suite / floor (optional). city: type: string region: type: string description: State / province / region. postal_code: type: string country: type: string description: ISO-3166 alpha-2 country code. NumberEmergencyAddress: type: object description: >- The E911 dispatchable address stored against a number, with its lifecycle status. `valid` is a local structural verdict only; `dispatchable` means a provider PSAP/MSAG confirmation has been recorded and an emergency call will route to the correct PSAP. properties: caller_name: type: string street_line_1: type: string street_line_2: type: string city: type: string region: type: string postal_code: type: string country: type: string registered_at: type: string format: date-time updated_at: type: string format: date-time validation_status: type: string enum: - registered - valid - invalid - dispatchable validated_at: type: string format: date-time nullable: true validation_issues: type: array items: type: string ResponseMeta: type: object required: - request_id - timestamp additionalProperties: false properties: request_id: type: string description: Unique request identifier (also returned as X-Request-Id header) timestamp: type: string format: date-time docs_url: type: string format: uri nullable: true securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: Dashboard JWT token from Clerk ApiKey: type: apiKey name: X-API-Key in: header description: Server-to-server API key (dv_live_sk_*) ````