Sample code for 30+ languages & platforms
C# 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 C# Downloads

C#
bool success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
//  Load an API key for the Twilio account from private application configuration.
Chilkat.Http http = new Chilkat.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 +.
Chilkat.StringBuilder number = new Chilkat.StringBuilder();
number.Append("020 7946 0018");
bool encoded = number.Encode("url_rfc3986","utf-8");
if (encoded != true) {
    Debug.WriteLine("Could not encode the phone number.");
    return;
}

Chilkat.StringBuilder url = new Chilkat.StringBuilder();
url.Append("https://lookups.twilio.com/v2/PhoneNumbers/");
url.Append(number.GetAsString());
url.Append("?CountryCode=GB");
Chilkat.HttpResponse resp = new Chilkat.HttpResponse();
Chilkat.JsonObject reply = new Chilkat.JsonObject();

success = http.HttpNoBody("GET",url.GetAsString(),resp);
if (resp.StatusCode == 0) {
    Debug.WriteLine("No HTTP response from Twilio.");
    return;
}

bool parsed = reply.Load(resp.BodyStr);
if ((success != true) || (resp.StatusCode != 200)) {
    Debug.WriteLine("Twilio returned HTTP " + Convert.ToString(resp.StatusCode));
    if ((parsed == true) && (reply.JsonTypeOf("code") == 2)) {
        Debug.WriteLine("Twilio error: " + Convert.ToString(reply.IntOf("code")) + "  " + reply.StringOf("message"));
    }

    return;
}

if (parsed != true) {
    Debug.WriteLine("Expected a JSON response from Twilio.");
    return;
}

if (reply.JsonTypeOf("valid") != 5) {
    Debug.WriteLine("The lookup response is missing the validity flag.");
    return;
}

if (reply.BoolOf("valid") != true) {
    Debug.WriteLine("The number is invalid for the specified country.");
    int i = 0;
    while ((i < reply.SizeOfArray("validation_errors"))) {
        reply.I = i;
        Debug.WriteLine(reply.StringOf("validation_errors[i]"));
        i = i + 1;
    }

    return;
}

if (reply.JsonTypeOf("phone_number") != 1) {
    Debug.WriteLine("The lookup response is missing the E.164 number.");
    return;
}

Debug.WriteLine("E.164: " + reply.StringOf("phone_number"));
Debug.WriteLine("National format: " + reply.StringOf("national_format"));