Fetch an instance of a Domain

GET /2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json

Custom DNS hostnames that can accept SIP traffic

Fetch an instance of a Domain

Path parameters

  • AccountSid string Required

    The SID of the Account that created the SipDomain resource to fetch.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

  • Sid string Required

    The Twilio-provided string that uniquely identifies the SipDomain resource to fetch.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^SD[0-9a-fA-F]{32}$.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the SipDomain resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • api_version string | null

      The API version used to process the call.

    • auth_type string | null

      The types of authentication you have mapped to your domain. Can be: IP_ACL and CREDENTIAL_LIST. If you have both defined for your domain, both will be returned in a comma delimited string. If auth_type is not defined, the domain will not be able to receive any traffic.

    • date_created string(date-time-rfc-2822) | null

      The date and time in GMT that the resource was created specified in RFC 2822 format.

    • date_updated string(date-time-rfc-2822) | null

      The date and time in GMT that the resource was last updated specified in RFC 2822 format.

    • domain_name string | null

      The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-" and must end with sip.twilio.com.

    • friendly_name string | null

      The string that you assigned to describe the resource.

    • sid string | null

      The unique string that that we created to identify the SipDomain resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^SD[0-9a-fA-F]{32}$.

    • uri string | null

      The URI of the resource, relative to https://api.twilio.com.

    • voice_fallback_method string(http-method) | null

      The HTTP method we use to call voice_fallback_url. Can be: GET or POST.

      Values are GET or POST.

    • voice_fallback_url string(uri) | null

      The URL that we call when an error occurs while retrieving or executing the TwiML requested from voice_url.

    • voice_method string(http-method) | null

      The HTTP method we use to call voice_url. Can be: GET or POST.

      Values are GET or POST.

    • voice_status_callback_method string(http-method) | null

      The HTTP method we use to call voice_status_callback_url. Either GET or POST.

      Values are GET or POST.

    • voice_status_callback_url string(uri) | null

      The URL that we call to pass status parameters (such as call ended) to your application.

    • voice_url string(uri) | null

      The URL we call using the voice_method when the domain receives a call.

    • subresource_uris object(uri-map) | null

      A list of mapping resources associated with the SIP Domain resource identified by their relative URIs.

    • sip_registration boolean | null

      Whether to allow SIP Endpoints to register with the domain to receive calls.

    • emergency_calling_enabled boolean | null

      Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.

    • secure boolean | null

      Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain.

    • byoc_trunk_sid string | null

      The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BY[0-9a-fA-F]{32}$.

    • emergency_caller_sid string | null

      Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^PN[0-9a-fA-F]{32}$.

GET /2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json
curl \
 --request GET 'https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json' \
 --user "username:password"
Response examples (200)
{
  "sid": "SDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/SIP/Domains/SDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
  "secure": true,
  "auth_type": "IP_ACL",
  "voice_url": "https://dundermifflin.example.com/twilio/app.php",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "api_version": "2010-04-01",
  "domain_name": "dunder-mifflin-scranton.sip.twilio.com",
  "date_created": "Mon, 20 Jul 2015 17:27:10 +0000",
  "date_updated": "Mon, 20 Jul 2015 17:27:10 +0000",
  "voice_method": "POST",
  "friendly_name": "Scranton Office",
  "byoc_trunk_sid": "BYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "sip_registration": true,
  "subresource_uris": {
    "credential_list_mappings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/SIP/Domains/SDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/CredentialListMappings.json",
    "ip_access_control_list_mappings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/SIP/Domains/SDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IpAccessControlListMappings.json"
  },
  "voice_fallback_url": null,
  "emergency_caller_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "voice_fallback_method": "POST",
  "emergency_calling_enabled": true,
  "voice_status_callback_url": null,
  "voice_status_callback_method": "POST"
}