Sample code for 30+ languages & platforms
Tcl Requires Chilkat v11.0.0+

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.

Twilio documentation

Chilkat Tcl Downloads

Tcl

load ./chilkat.dll

set success 0

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
#  Load an API key for the Twilio account from private application configuration.
set http [new_CkHttp]

CkHttp_put_RequireSslCertVerify $http 1
CkHttp_put_BasicAuth $http 1
CkHttp_put_Login $http "YOUR_API_KEY_SID"
CkHttp_put_Password $http "YOUR_API_KEY_SECRET"

#  The phone number is one URL path segment. Percent-encode spaces and any leading +.
set number [new_CkStringBuilder]

CkStringBuilder_Append $number "020 7946 0018"
set encoded [CkStringBuilder_Encode $number "url_rfc3986" "utf-8"]
if {$encoded != 1} then {
    puts "Could not encode the phone number."
    delete_CkHttp $http
    delete_CkStringBuilder $number
    exit
}

set url [new_CkStringBuilder]

CkStringBuilder_Append $url "https://lookups.twilio.com/v2/PhoneNumbers/"
CkStringBuilder_Append $url [CkStringBuilder_getAsString $number]
CkStringBuilder_Append $url "?CountryCode=GB"
set resp [new_CkHttpResponse]

set reply [new_CkJsonObject]

set success [CkHttp_HttpNoBody $http "GET" [CkStringBuilder_getAsString $url] $resp]
if {[CkHttpResponse_get_StatusCode $resp] == 0} then {
    puts "No HTTP response from Twilio."
    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

set parsed [CkJsonObject_Load $reply [CkHttpResponse_bodyStr $resp]]
if {expr [$success != 1]  ||  [[CkHttpResponse_get_StatusCode $resp] != 200]} then {
    puts "Twilio returned HTTP [CkHttpResponse_get_StatusCode $resp]"
    if {expr [$parsed == 1]  &&  [[CkJsonObject_JsonTypeOf $reply "code"] == 2]} then {
        puts "Twilio error: [CkJsonObject_IntOf $reply code]  [CkJsonObject_stringOf $reply message]"
    }

    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {$parsed != 1} then {
    puts "Expected a JSON response from Twilio."
    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {[CkJsonObject_JsonTypeOf $reply "valid"] != 5} then {
    puts "The lookup response is missing the validity flag."
    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {[CkJsonObject_BoolOf $reply "valid"] != 1} then {
    puts "The number is invalid for the specified country."
    set i 0
    while {$i < [CkJsonObject_SizeOfArray $reply "validation_errors"]} {
        CkJsonObject_put_I $reply $i
        puts [CkJsonObject_stringOf $reply {validation_errors[i]}]
        set i [expr $i + 1]
    }
    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {[CkJsonObject_JsonTypeOf $reply "phone_number"] != 1} then {
    puts "The lookup response is missing the E.164 number."
    delete_CkHttp $http
    delete_CkStringBuilder $number
    delete_CkStringBuilder $url
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

puts "E.164: [CkJsonObject_stringOf $reply phone_number]"
puts "National format: [CkJsonObject_stringOf $reply national_format]"

delete_CkHttp $http
delete_CkStringBuilder $number
delete_CkStringBuilder $url
delete_CkHttpResponse $resp
delete_CkJsonObject $reply