E911 Configuration

Configure emergency services (E911) for your phone numbers.

Overview

E911 (Enhanced 911) is a critical service that enables emergency dispatchers to locate callers. Proper E911 configuration is required by law in many jurisdictions.

Important: E911 configuration is mandatory for any numbers used for voice calling. Non-compliance can result in fines and account suspension.

Set E911 Address

Register an emergency address for a phone number.

Endpoint

PUT https://api.audian.com:8443/v2/numbers/{number_id}/e911

Parameters

Parameter	Type	Required	Description
address_line_1	string	Yes	Street address (max 100 characters)
address_line_2	string	No	Apartment, suite, floor (max 100 characters)
city	string	Yes	City name
state	string	Yes	State or province
postal_code	string	Yes	ZIP or postal code
country	string	Yes	Country code (e.g., "US")
customer_name	string	Yes	Name of the number owner (max 50 characters)
customer_phone	string	No	Contact phone number

Request Example

curl -X PUT 'https://api.audian.com:8443/v2/numbers/num_abc123/e911' \
  -H 'X-Auth-Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "address_line_1": "123 Main Street",
    "address_line_2": "Suite 100",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94102",
    "country": "US",
    "customer_name": "Acme Corporation",
    "customer_phone": "+14155551234"
  }'

Response

{
  "success": true,
  "data": {
    "number": "+14155551234",
    "e911_address": {
      "address_line_1": "123 Main Street",
      "address_line_2": "Suite 100",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "US"
    },
    "customer_name": "Acme Corporation",
    "status": "active",
    "validated_at": "2024-01-15T10:30:00Z"
  }
}

Get E911 Address

Retrieve the E911 address for a phone number.

Endpoint

GET https://api.audian.com:8443/v2/numbers/{number_id}/e911

Request Example

curl -X GET 'https://api.audian.com:8443/v2/numbers/num_abc123/e911' \
  -H 'X-Auth-Token: YOUR_API_KEY'

Delete E911 Address

Remove the E911 address from a phone number.

Endpoint

DELETE https://api.audian.com:8443/v2/numbers/{number_id}/e911

Request Example

curl -X DELETE 'https://api.audian.com:8443/v2/numbers/num_abc123/e911' \
  -H 'X-Auth-Token: YOUR_API_KEY'

Response

{
  "success": true,
  "data": {
    "number": "+14155551234",
    "message": "E911 address has been removed"
  }
}

Address Validation

Addresses are automatically validated when submitted. Invalid addresses will be rejected.

Validation Rules

• Street Address: Must contain street name and number
• City: Must be a valid city in the specified state
• State: Must be valid 2-letter state code or province
• Postal Code: Must be valid for the specified location
• Country: Must be supported (US and CA)

Address Validation Response

If validation fails, you'll receive an error:

{
  "success": false,
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The address provided could not be validated",
    "details": {
      "invalid_fields": ["postal_code"]
    }
  }
}

E911 Requirements by Use Case

Business Numbers

• Use your business address
• Use your business name
• Include suite or office number if applicable

Mobile Users / Hoteling

• Use primary office location
• Not suitable for mobile users with multiple locations
• Consider dedicated lines for each location

Multi-Location Business

• Register E911 for each physical location separately
• Use unique phone numbers per location if possible
• Update E911 if you relocate

E911 Address Format Examples

United States

{
  "address_line_1": "123 Main Street",
  "address_line_2": "Suite 200",
  "city": "New York",
  "state": "NY",
  "postal_code": "10001",
  "country": "US"
}

Canada

{
  "address_line_1": "456 King Street West",
  "address_line_2": "Floor 5",
  "city": "Toronto",
  "state": "ON",
  "postal_code": "M5H 1A1",
  "country": "CA"
}

E911 and Your Responsibilities

When you configure E911, you understand:

1. Accurate Information: Address must be where services are actually provided
2. Timely Updates: Update address within 30 days of relocation
3. Emergency Response: Incorrect addresses may result in emergency response delays
4. Legal Compliance: E911 configuration is required by law
5. Liability: You are responsible for address accuracy

Common Issues

Issue	Solution
Address validation fails	Verify exact street name and number
City not recognized	Try alternate spelling or nearby city
Invalid postal code	Check postal code format for your country
Address ambiguous	Include suite/floor number for clarity

Updating E911 Address

To update an existing E911 address:

1. Send a new PUT request with updated address
2. Address will be re-validated
3. Previous address is replaced
4. Changes take effect immediately

E911 Limitations

• Updates: Can be updated once per 30 days
• Required: E911 address is required for voice numbers
• Geographic: Address must match service location
• Countries: Currently supports US and Canada

E911 Best Practices

1. Use Real Address: Always use your actual business address
2. Include Suite Number: Specify suite/floor for buildings
3. Verify Accuracy: Double-check address before submitting
4. Keep Updated: Update immediately if you relocate
5. Test Service: Verify 911 calls work from your location
6. Document Changes: Keep records of address changes

Support and Compliance

For E911 configuration issues or questions about compliance:

• Contact Audian support with your phone number
• Provide exact business address
• Include any relevant documentation

Non-compliance with E911 requirements may result in service suspension.