Python Requires Chilkat v11.0.0+
Python
Validate and format a phone number with Twilio Lookup
See more Twilio Examples
Use Basic Lookup v2 to check a national-format number and obtain its E.164 and national display formats. Supply the two-letter country code for a national number. The example requests only the basic fields.
Read the boolean valid field even when the HTTP request succeeds. When it is false, display any validation_errors that Twilio supplies. Numbering-plan validation does not establish reachability or control of a phone. To confirm control, send an SMS verification code.
Chilkat Python Downloads
import sys
import chilkat2
success = False
# Assumes Chilkat is unlocked. See Global Unlock Sample.
# Load an API key for the Twilio account from private application configuration.
http = chilkat2.Http()
http.RequireSslCertVerify = True
http.BasicAuth = True
http.Login = "YOUR_API_KEY_SID"
http.Password = "YOUR_API_KEY_SECRET"
# The phone number is one URL path segment. Percent-encode spaces and any leading +.
number = chilkat2.StringBuilder()
number.Append("020 7946 0018")
encoded = number.Encode("url_rfc3986","utf-8")
if (encoded != True):
print("Could not encode the phone number.")
sys.exit()
url = chilkat2.StringBuilder()
url.Append("https://lookups.twilio.com/v2/PhoneNumbers/")
url.Append(number.GetAsString())
url.Append("?CountryCode=GB")
resp = chilkat2.HttpResponse()
reply = chilkat2.JsonObject()
success = http.HttpNoBody("GET",url.GetAsString(),resp)
if (resp.StatusCode == 0):
print("No HTTP response from Twilio.")
sys.exit()
parsed = reply.Load(resp.BodyStr)
if ((success != True) or (resp.StatusCode != 200)):
print("Twilio returned HTTP " + str(resp.StatusCode))
if ((parsed == True) and (reply.JsonTypeOf("code") == 2)):
print("Twilio error: " + str(reply.IntOf("code")) + " " + reply.StringOf("message"))
sys.exit()
if (parsed != True):
print("Expected a JSON response from Twilio.")
sys.exit()
if (reply.JsonTypeOf("valid") != 5):
print("The lookup response is missing the validity flag.")
sys.exit()
if (reply.BoolOf("valid") != True):
print("The number is invalid for the specified country.")
i = 0
while (i < reply.SizeOfArray("validation_errors")) :
reply.I = i
print(reply.StringOf("validation_errors[i]"))
i = i + 1
sys.exit()
if (reply.JsonTypeOf("phone_number") != 1):
print("The lookup response is missing the E.164 number.")
sys.exit()
print("E.164: " + reply.StringOf("phone_number"))
print("National format: " + reply.StringOf("national_format"))