DID Emergency Object

The DID Emergency Object defines the emergency service information associated with a DID (phone number). It contains configuration details such as the caller name displayed to emergency operators, the activation status of the emergency record, and the list of registered emergency locations.

This object ensures that each DID can be properly identified and routed in emergency situations, with accurate address information and caller identification maintained in compliance with local regulations.

DID Emergency Object Attributes

These fields and values make up the JSON response that gets returned when a request is successful.

Attribute	Data Type	Description
caller_name update	string	The name that will appear on receiving party phones.
enabled update	boolean	If this field is set to false, no record is stored in the central CNAM registry. Fields can still be updated when the value is false.
locations update	array of objects	The list of locations that will be used for emergency. Refer to the table below for the description of the location object parameters.

Location Object

The Location Object represents a single physical address used for emergency response purposes. Each location contains the full address details—such as street, city, state, postal code, and country code—that are registered for emergency services.

Attribute	Data Type	Description
address_1 update	string	The emergency location address line 1.
address_2 update	string	The emergency location address line 2.
city update	string	The emergency location city.
country_code update	string	The ISO 3166-1 alpha-3 code of this emergency location country.
state update	string	The emergency location state in a two-letter abbreviation format.
zip update	string	The emergency location zip code.

Sample DID Emergency Object

{
    "caller_name": "J Smith",
    "enabled": true,
    "locations": [
        {
            "address_1": "8104 E Nora Ave",
            "address_2": "",
            "city": "Spokane Valley",
            "country_code": "USA",
            "state": "WA",
            "zip": "99212"
        }
    ]
}