The 933 service

Sarah Krawiec

Updated May 07, 2024 19:58

The 933 service is a courtesy text-to-speech service offered as part of Bandwidth's 911 package. It’s intended to be used during the onboarding process to test connectivity to the emergency IPs for the 911 service before making live 911 calls.

Note: Although the 933 service is available anytime (please limit to 1 call per minute), it's not meant to be used as a fully functional address verification service. Instead, it's best to check the provisioned address directly in the portal or via the API call. If there's a port in progress, always test 933 after it completes, even if the address was pre-provisioned before porting.

When you make a 933 call, the service will read back the number you’re calling from and the address provisioned for that number (please note that it won't provide the Subscriber Name). If the address read back isn’t the one you want to be provisioned for that endpoint, please update the appropriate endpoint or modify the associated geolocation.

A 933 call result with an error code indicates that an issue has prevented the location from being provisioned. Depending on the issue, the readback message may provide additional details to help identify the root cause. The 933 readback messages are also available via email notifications.

Standard 911

Status	Readback message	Explanation
Provisioned	“You have reached the 911 Address Validation Service. You are calling from [1+number]. Your 911 address is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. Your 911 service is active.”	The phone was correctly installed and the 911 information was properly provisioned. No further action is needed.
Unprovisioned	"You have reached the 911 Address Validation Service. You are calling from [1+number]. There is no record found matching this telephone number. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 1A.”	The phone number wasn’t found because no endpoint record exists for it. You need to add the endpoint to your 911 account.
Unprovisioned	“You have reached the 911 Address Validation Service. You are calling from [1+number]. There is no 911 address configured for this telephone number. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 1B.”	The phone number was found but the address is completely unprovisioned (missing/blank). While the number is in your 911 account, there’s no provisioned or valid address associated with it. You need to update the address for this endpoint.

Dynamic Location Routing

Status	Readback message	Explanation
Provisioned	“You have made a test emergency call. The callback number associated with your service is [1+number]. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. Your 911 service is active.”	The phone was correctly installed and the 911 information was properly provisioned. No further action is needed.
Provisioned	“You have made a test emergency call providing latitude-longitude. The callback number associated with your service is [1+number]. The nearest estimated address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. Your 911 service is active.”	An alternate End User Identifier (AEUI) was found, a Geolocation record has been provided as an X-Y, and a callback number has been supplied. The X-Y successfully converts to a civic address. No further action is needed.
Provisioned	“You have made a test emergency call providing latitude-longitude. The callback number associated with your service is [1+number]. The provided latitude-longitude is [digits]. This latitude-longitude cannot be converted to an address. Your 911 service is active."	AEUI was found, a Geolocation record has been provided as an X-Y, and a callback number has been supplied. The X-Y doesn’t successfully convert to a civic address but is still in the USA-Canada polygon and can be processed. No further action is needed.
Unprovisioned	“You have made a test emergency call. You are calling from an unknown or unregistered device. The address for this test call is [text-to-speech of Address_Line_1 and Address_Line_2, City, State, Zip, CountryCode]. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2A.”	AEUI wasn’t found (i.e., no endpoint record exists for the supplied FROM or P-Asserted field content) and a Geolocation record has been provided, and a match was found.
Unprovisioned	“You have made a test emergency call. You are calling from an unknown or unregistered device. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2B.”	AEUI wasn’t found (i.e., no endpoint record exists for the supplied FROM or P-Asserted field content) AND no Geolocation record has been provided or no match was found.
Unprovisioned	“You have made a test emergency call. The callback number associated with your service is missing. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2C.”	AEUI was found but no Geolocation record AND no callback have been provided.
Unprovisioned	“You have made a test emergency call. The callback number associated with your service is missing. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2D.”	AEUI was found and a Geolocation record has been provided BUT no callback number has been supplied.
Unprovisioned	“You have made a test emergency call. The callback number associated with your service is [1+number]. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2E.”	AEUI was found but no Geolocation record has been provided. A callback number has been supplied.
Unprovisioned	“You have made a test emergency call providing latitude-longitude. The callback number associated with your service is [1+number]. The provided latitude-longitude is outside the known PSAP boundaries, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 2F."	AEUI was found, a Geolocation record has been provided as an X-Y, and a callback number has been supplied. The X-Y is outside of the boundaries of the USA, Canada, territories, and territorial waters.
Other	"You have made a test emergency call. The callback number associated with your service is [1+number]. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. The address for this device is valid but the associated method parameter specifies a 911 call would be routed to the national Emergency Call Center. Your 911 service is active. Reference Code 2G."	AEUI was found, a Geolocation record has been provided, and the callback number has been supplied. However, the “method” parameter has prevented automatic call routing. The call would go to the ECC.

Dynamic Location Routing for Microsoft Teams

Status	Readback message	Explanation
Provisioned	“You have made a test emergency call from a nomadic device. The callback number associated with your service is [1+number]. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. Your 911 service is active.”	The phone was correctly installed and the 911 information was properly provisioned.
Provisioned	“You have made a test emergency call providing latitude-longitude from a nomadic device. The callback number associated with your service is [1+number]. The nearest estimated address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. Your 911 service is active."	AEUI was found, a Geolocation record has been provided as an X-Y, and a callback number has been supplied. The X-Y successfully converts to a civic address.
Provisioned	“You have made a test emergency call providing latitude-longitude from a nomadic device. The callback number associated with your service is [1+number]. The provided latitude-longitude is [digits]. This latitude-longitude cannot be converted to an address. Your 911 service is active."	AEUI was found, a Geolocation record has been provided as an X-Y, and a callback number has been supplied. The X-Y doesn’t successfully convert to a civic address but is still in the USA-Canada polygon and can be processed.
Unprovisioned	“You have made a test emergency call from a nomadic device. You are calling from an unknown or unregistered device. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3A.”	AEUI wasn’t found (i.e., no endpoint record exists for the supplied FROM or P-Asserted field content) and no Geolocation record has been provided or no match was found.
Unprovisioned	“You have made a test emergency call from a nomadic device. The callback number associated with your service is missing. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3B.”	AEUI was found but no Geolocation record has been provided AND no callback number has been supplied.
Unprovisioned	“You have made a test emergency call from a nomadic device. The callback number associated with your service is missing. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3C.”	AEUI was found and a Geolocation record has been provided BUT no callback number has been supplied.
Unprovisioned	“You have made a test emergency call from a nomadic device. The callback number associated with your service is [1+number]. The location information for this call is either missing or incomplete. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3D.”	AEUI was found but no Geolocation record has been provided. A callback number has been supplied.
Unprovisioned	“You have made a test emergency call providing latitude-longitude from a nomadic device. The callback number associated with your service is [1+number]. The provided latitude-longitude is outside the known PSAP boundaries, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3E."	AEUI was found, a Geolocation record has been provided as an X-Y, and a callback number has been provided. The X-Y is outside of the boundaries of the USA, Canada, territories, and territorial waters.
Unprovisioned	"You have made a test emergency call from a nomadic device. You are calling from an unknown or unregistered device. The address for this test call is [text-to-speech of Address_Line_1 and Address_Line_2]. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 3F."	AEUI wasn’t found (i.e., no endpoint record exists for the supplied FROM or P-Asserted field content) and a Geolocation record has been provided, and a match was found.
Other	“You have made a test emergency call from a nomadic device. The callback number associated with your service is [1+number]. The address for this test call is [text-to-speech of Address_Line_1, Address_Line_2, City, State, Zip, CountryCode]. The address for this device is valid but the associated method parameter specifies a 911 call would be routed to the National Emergency Call Center. Your 911 service is active. Reference code 3G.”	AEUI was found, a Geolocation record has been provided, and the callback number has been supplied, but the “method” parameter has prevented automatic call routing. The call will go to the Emergency Call Center (ECC).

Uncommon errors

Status	Readback message	Explanation
Provisioned	"You have reached the 911 Address Validation Service. The callback number associated with your service is [1+number]. Test emergency calling is unable to provide more details on this type of provisioned call. Your 911 service is active."	This is a provisioned call but we don’t have enough information to provide more details from the way the call was set up. Please contact the Bandwidth Support Team for more information.
Unprovisioned	"You have reached the 911 Address Validation Service. The callback number associated with your service is [1+number]. Test emergency calling is unable to provide more details on this type of unprovisioned call. The 911 PSAP routing service for the number you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 5."	This is an unprovisioned call that would route to the ECC if 911 were to be dialed.
Provisioned	"You have reached the 911 Address Validation Service. Test emergency calling is unable to provide more details on this type of provisioned call. Your 911 service is active."	This is a provisioned call but we don’t have enough information to provide more details from the way the call was set up. Please contact the Bandwidth Support Team for more information.
Unprovisioned	"You have made a test emergency call. You are calling from an unknown or unregistered device. The 911 PSAP routing service for the device you are calling from is not active, and a 911 call would be routed to the national Emergency Call Center. Please contact your service provider immediately to configure your 911 service. Reference code 6."	This is an unprovisioned call that would route to the ECC if 911 were to be dialed.
Other	“Test emergency calling could not determine the status of this call. Please try again later. Reference code 7.”	Due to a network condition, this 933 test call couldn’t be completed as expected. Please try again or contact the Bandwidth Support Team.
Other	“Test emergency calling encountered an unexpected error while processing your request. Please try again later. Reference code 8.”
Other	“Test emergency calling is not yet configured for this type of call. Please try again later. Reference code 9.”

Was this article helpful?

Article is closed for comments.