E911 provisioning.

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

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.