VoiceTel

Documentation / E911

E911 provisioning.

Every VoiceTel number that handles inbound voice traffic can be provisioned with an E911 record so emergency calls route to the correct PSAP with your registered address and caller name. E911 records are managed via the v2.2 REST API at https://api.voicetel.com/v2.2/e911.

Provision E911 Sign up

How it works

Provisioning an E911 record is a two-step process:

  1. Validate the address — POST the street address to /v2.2/e911/validations. The API normalizes and verifies the address against the ALI (Automatic Location Identification) database and returns an addressid.
  2. Provision the number — PUT the addressid and caller name to /v2.2/e911/{dn} to bind the validated address to a specific phone number on your account.

You can also create a record in a single step by POSTing the full address and phone number to /v2.2/e911. The API validates and provisions in one request.

API endpoints

Method Endpoint Description
POST /v2.2/e911/validations Validate an address and receive an addressid
POST /v2.2/e911 Create an E911 record (validate + provision in one step)
PUT /v2.2/e911/{dn} Provision or update E911 with a known addressid
GET /v2.2/e911 List all E911 records on the account
GET /v2.2/e911/{dn} Get E911 record for a specific number
DELETE /v2.2/e911/{dn} Remove E911 record from a number

Full request/response schemas are documented in the v2.2 API reference. Try endpoints live in the API playground.

Step 1: Validate an address

Before provisioning, validate the address against the ALI database. This confirms the address is serviceable and returns a stable addressid you can reuse across multiple numbers at the same location.

Request

POST https://api.voicetel.com/v2.2/e911/validations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "address1": "123 Main Street",
  "address2": "Suite 400",
  "city": "Newark",
  "state": "NJ",
  "zip": "07102"
}

Response

{
  "status": "success",
  "data": {
    "address": {
      "addressid": 48291,
      "address1": "123 MAIN ST",
      "address2": "STE 400",
      "city": "NEWARK",
      "state": "NJ",
      "zip": "07102"
    }
  }
}

The response returns the normalized address. Save the addressid for provisioning.

Step 2: Provision a number

Bind the validated address to a phone number on your account. The callername is what the PSAP dispatcher sees when the caller dials 911.

Request

PUT https://api.voicetel.com/v2.2/e911/2015551234
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "addressid": 48291,
  "callername": "Acme Corp Main Office"
}

Response

{
  "status": "success",
  "data": {
    "record": {
      "dn": "12015551234",
      "callername": "Acme Corp Main Office",
      "address1": "123 MAIN ST",
      "address2": "STE 400",
      "city": "NEWARK",
      "state": "NJ",
      "zip": "07102"
    }
  }
}

Alternative: single-step provisioning

If you only need to provision one number at an address, you can skip the separate validation step and POST the full record directly.

POST https://api.voicetel.com/v2.2/e911
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "dn": "2015551234",
  "callername": "Acme Corp Main Office",
  "address1": "123 Main Street",
  "address2": "Suite 400",
  "city": "Newark",
  "state": "NJ",
  "zip": "07102"
}

The API validates the address and provisions the number in a single request. For multiple numbers at the same address, use the two-step flow to avoid redundant validation.

Query and manage records

List all E911 records

GET https://api.voicetel.com/v2.2/e911
Authorization: Bearer YOUR_API_KEY

Get a specific record

GET https://api.voicetel.com/v2.2/e911/2015551234
Authorization: Bearer YOUR_API_KEY

Update a record

To change the address on a number, validate the new address first, then PUT the new addressid. To change only the caller name, PUT with the existing addressid and the new callername.

Remove a record

DELETE https://api.voicetel.com/v2.2/e911/2015551234
Authorization: Bearer YOUR_API_KEY

Removing an E911 record means emergency calls from that number will no longer route to a PSAP with your registered address. Only remove records when the number is being released or reassigned.

Important notes

  • E911 address validation checks the ALI database maintained by the Master Street Address Guide (MSAG). Not all addresses are serviceable — the API will return an error for addresses that cannot be validated.
  • The dn must be a ten-digit US telephone number owned by the authenticated account.
  • The callername is limited to 20 characters by PSAP display standards.
  • Address changes may take up to 24 hours to propagate to all downstream PSAP databases.
  • E911 is a US-only service. International emergency service routing is not available.
  • VoIP-based E911 has inherent limitations compared to wireline 911 service. Customers must inform end-users of these limitations per FCC requirements. See terms of service for details.

Trusted by