Menu

Expand
Rate this page:

Emergency Calling for SIP Interfaces API

Twilio's Emergency Calling enables 911 call routing to Public Safety Answering Points (PSAPs) in the US and Canada.

Emergency calling is enabled on a per Phone Number basis. This page outlines the process you should follow to enable/disable E911 on Phone Number using Programmable Voice SIP Interfaces. Please ensure that you also read our Emergency Calling documentation.

Phone Number instances are managed through the core Twilio REST API. Check out the Phone Number reference docs for more information.

Enable Emergency Calling on a Twilio Number

  • Create and validate a new Emergency Address
  • Associate an Emergency Address with a Twilio number
  • Enable Emergency Calling on a Twilio number
  • Check Emergency Calling Status on a Twilio number
  • Enable Emergency Calling on a SIP Domain

Disable Emergency Calling on a Twilio Number

  • Disable Emergency Calling on a Twilio number
  • Check Emergency Calling Status on a Twilio number
  • Disassociate an Emergency Address from a Twilio number
  • Delete an Emergency Address
  • Disable Emergency Calling on a SIP Domain

Changing the Emergency Address on a Twilio Number

  • Disable Emergency Calling on your Twilio Number
  • Check Emergency Calling Status on a Twilio number to ensure it's Inactive
  • Associate new Emergency Address with Twilio Number
  • Enable Emergency Calling on the Twilio Number
  • Check Emergency Calling Status on a Twilio number to ensure it's Active

Add Emergency Caller ID

  • Set Emergency Enabled Twilio Phone Number as Emergency Caller ID

Actions

Create and validate a new Emergency Address

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses

Create a new Address and validate it for Emergency Calling by setting the EmergencyEnabled parameter to true.

        
        
        
        
        Ensure to set EmergencyEnabled to True

        Create and validate a new Emergency Address

        Ensure to set EmergencyEnabled to True
        Example Response(s)

        A new address might be suggested as part of the validation process:

        <?xml version='1.0' encoding='UTF-8'?>
        <TwilioResponse>
         <RestException>
          <Code>21629</Code>
          <Message>Failed to validate address. Check the suggested address. | FriendlyName: Twilio, CustomerName: Twilio, Street: 645 HARRISON ST, Locality: SAN FRANCISCO, Region: CA, PostalCode: 94105, IsoCountry: US</Message>
          <MoreInfo>https://www.twilio.com/docs/errors/21629</MoreInfo>
          <Status>400</Status>
         </RestException>
        </TwilioResponse>
        }
        

        Associate an Emergency Address with a Twilio number

        post
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}
              
              
              
              

              You can disassociate an Emergency Address by updating the the emergency_address_sid to null (or undefined, None or nil depending on your programming language).

              For curl leave the right side of the = blank:

              curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/IncomingPhoneNumbers/PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json \
              --data-urlencode "EmergencyAddressSid=" \
              -u ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token
              

              Enable and disable Emergency Calling

              post
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}

              Please note that this step must not be combined with the previous one, they must be two separate API calls. You must associate/disassociate and then enable/disable.

                    
                    
                    
                    

                    Note the EmergencyStatus parameter will change to Pending Activation. This process might take up to 5 minutes.

                          
                          
                          
                          

                          Note the EmergencyStatus parameter will change to Pending Deactivation. This process may take up to 5 minutes.

                          Check Emergency Calling Status on a Twilio number

                          get
                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}
                                
                                
                                
                                

                                Delete an Emergency Address

                                delete
                                https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}
                                      
                                      
                                      
                                      

                                      Enable and Disable Emergency Calling on SIP Domain

                                      post
                                      https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{SipDomainSid}
                                            
                                            
                                            
                                            
                                                  
                                                  
                                                  
                                                  
                                                        
                                                        
                                                        
                                                        
                                                        Phone Number SID of an emergency enabled Twilio phone number. If present, this phone number will be used as the callback for the emergency call.

                                                        Add Emergency Caller ID

                                                        Phone Number SID of an emergency enabled Twilio phone number. If present, this phone number will be used as the callback for the emergency call.
                                                        Rate this page:

                                                        Need some help?

                                                        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

                                                              
                                                              
                                                              

                                                              Thank you for your feedback!

                                                              We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                                                              Sending your feedback...
                                                              🎉 Thank you for your feedback!
                                                              Something went wrong. Please try again.

                                                              Thanks for your feedback!

                                                              Refer us and get $10 in 3 simple steps!

                                                              Step 1

                                                              Get link

                                                              Get a free personal referral link here

                                                              Step 2

                                                              Give $10

                                                              Your user signs up and upgrade using link

                                                              Step 3

                                                              Get $10

                                                              1,250 free SMSes
                                                              OR 1,000 free voice mins
                                                              OR 12,000 chats
                                                              OR more