Emergency Resources

Emergency Resources allow customers to register their DID numbers for emergency calling services (E911/E112) via API.

The emergency registration requirements are unique to each country and type of DID number. DIDWW customers have an obligation to provide valid address and identity information in order to activate emergency calling for their DID numbers.

To review the emergency registration requirements for each individual country and number type you can use the Emergency Requirements resource.

All verifications will be reviewed by the DIDWW Emergency Team. Once approved, when the Emergency Calling Service status becomes active, emergency routing is enabled for the DIDs associated with the verification and the calling service.

How to Register Emergency Calling Service

For the full step-by-step guide, see Register Emergency Calling Service.

To create an emergency calling registration for your DIDs, the following steps are required:

Check the Emergency Requirements for the country and DID group type you want to register.
Create an Identity. Two types of identities are supported:
1. Personal Identity
2. Business Identity
Create an Address.
Validate the identity and address against the emergency requirement.
Submit an Emergency Verification in New Calling Service mode. Provide the address and the DIDs to register. A new Emergency Calling Service will be created automatically.
The verification will be reviewed by the DIDWW Emergency Team.
Once the Emergency Verification is approved and the associated Emergency Calling Service status changes to active, emergency routing is enabled for the DIDs specified in the Emergency Verification.
If rejected, the status changes to changes_required. Review the reject_reasons field and resubmit a new verification with corrected data.

Updating an Existing Emergency Calling Service

For the full step-by-step guide, see Update Emergency Calling Service.

To update the address on an already active Emergency Calling Services resource:

Submit a new Emergency Verification in Existing Calling Service mode. Provide the new address and the existing emergency_calling_service relationship.
The calling service status changes to pending_update while under review.
Once approved, the service becomes active with the updated address.

Note

Adding or removing DIDs from an existing Emergency Calling Service is only possible through the DID resource.

Requirement Address Area Level

The Emergency Requirement enforces that the registered Address must be from a specific geographic area.

The address_area_level attribute may be one of the following:

Value	Description
country	Address must be within the requirement country
area	Address must be within the locality or region covered by the phone number’s prefix
city	Address must be from the same city as the registered DIDs

Requirement Identity Area Level

The Emergency Requirement may enforce that the Identity must be from a specific country.

The personal_area_level and/or business_area_level attributes may be one of the following:

Value	Description
world_wide	Identity from any country can be used
country	Identity must be within the requirement country

Requirement Mandatory Fields

The Emergency Requirement may require certain optional Identity or Address fields to be filled in.

If the requirement has personal_mandatory_fields, business_mandatory_fields, or address_mandatory_fields, the corresponding attributes of the Identity or Address must be provided.

Following mandatory values can be included in personal_mandatory_fields and/or business_mandatory_fields:

Attribute	Description
birth_date	Birth Date of a Person
personal_tax_id	Personal Tax Number
id_number	Proof of ID
vat_id	VAT / TAX Number
company_reg_number	Company Registration Number
contact_email	Contact email address
country	Country of Tax Residence
company_representative_date_of_birth	Company Representative Date of Birth

Following mandatory values can be included in address_mandatory_fields:

Attribute	Description
area	State / Province / Region

Emergency Calling Service Status Values

Status	Description
new	Service created, awaiting first verification submission
in_process	Verification submitted and under review by DIDWW Emergency Team
changes_required	Verification was rejected and a new verification must be submitted
pending_update	Active service with an updated verification under review
active	Service is approved and emergency calling is operational
canceled	Service has been permanently canceled

Emergency Resources Overview

Emergency Requirements - Read-only. Describes registration requirements per country and DID group type, including required identity type, address area level, mandatory fields, estimated setup time, and pricing.
Emergency Requirement Validations - Write-only. Checks whether an Address and / or Identity satisfies a selected Emergency Requirement before an Emergency Verification is submitted.
Emergency Calling Services - Read and delete. The main entity representing an active emergency subscription tied to a customer’s DIDs.
Emergency Verifications - Read, create, and update. Verification requests submitted for review. Supports callbacks on status change and updating external_reference_id.