[BUG] Regulatory Compliance API uses deprecated `numbers.ie1.twilio.com` hostname causing SSL certificate mismatch when `region='ie1'`

[lucassing]

Describe the bug

When initializing the Twilio client with region='ie1', the Regulatory Compliance API (numbers.v2.regulatory_compliance) resolves to https://numbers.ie1.twilio.com. However, this hostname is no longer present in the SSL certificate's SANs, causing SSLCertVerificationError: certificate verify failed: Hostname mismatch.

Code snippet

from twilio.rest import Client

client = Client(account_sid, auth_token, region='ie1')
# This hits https://numbers.ie1.twilio.com and fails SSL verification
regulations = client.numbers.v2.regulatory_compliance.regulations.list()

Actual behavior

SSLError: HTTPSConnectionPool(host='numbers.ie1.twilio.com', port=443): 
Max retries exceeded with url: /v2/RegulatoryCompliance/Regulations...
Caused by SSLError(SSLCertVerificationError(1, 
"[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: Hostname mismatch, 
certificate is not valid for 'numbers.ie1.twilio.com'"))

Expected behavior

The SDK should route to the new localized domain pattern or at minimum use a hostname with a valid certificate.

twilio-python version

9.10.4

Python version

3.11.9

Logs or error messages

No response

Additional context

No response

[gbochenek]

Hi @lucassing !

We dug into this a bit more. The primary issue here is that the numbers domain is a global resource and not available over ie1 url patterns.  To get this working in the SDK, you will need to create a separate context that is not localized to ie1 and make the phone number calls from there.

In the meantime, we'll be looking into better ways to handle these sort of resources (and at the very least provide clearer error messages and documentation).

Let us know if you run into any more problems. Thanks!

Here's what that might look like in Python:

from twilio.rest import Client

  account_sid = 'your_account_sid'
  auth_token = 'your_auth_token'

  # Main client for global APIs (regulatory compliance, etc.)
  client = Client(account_sid, auth_token)

  # Fetch regulatory compliance bundles - MUST use main client
  bundles = client.numbers.v2.regulatory_compliance.bundles.list(limit=20)

  for bundle in bundles:
      print(f"Bundle SID: {bundle.sid}")
      print(f"Status: {bundle.status}")
      print(f"Friendly Name: {bundle.friendly_name}")
      print("---")

  # Create a separate client for ie1-localized operations
  client_ie1 = Client(
      account_sid,
      auth_token,
      region='ie1',
      edge='dublin'
  )

  # These operations CAN be localized to ie1:

  # Send a message through ie1
  message = client_ie1.messages.create(
      to='+353...',
      from_='+353...',
      body='Message routed through ie1'
  )

  # Make a voice call through ie1
  call = client_ie1.calls.create(
      to='+353...',
      from_='+353...',
      url='http://demo.twilio.com/docs/voice.xml'
  )