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

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Load an API key for the Twilio account from private application configuration.
    CkHttp http = new CkHttp();
    http.put_RequireSslCertVerify(true);
    http.put_BasicAuth(true);
    http.put_Login("YOUR_API_KEY_SID");
    http.put_Password("YOUR_API_KEY_SECRET");

    //  The phone number is one URL path segment. Percent-encode spaces and any leading +.
    CkStringBuilder number = new CkStringBuilder();
    number.Append("020 7946 0018");
    boolean encoded = number.Encode("url_rfc3986","utf-8");
    if (encoded != true) {
        System.out.println("Could not encode the phone number.");
        return;
        }

    CkStringBuilder url = new CkStringBuilder();
    url.Append("https://lookups.twilio.com/v2/PhoneNumbers/");
    url.Append(number.getAsString());
    url.Append("?CountryCode=GB");
    CkHttpResponse resp = new CkHttpResponse();
    CkJsonObject reply = new CkJsonObject();

    success = http.HttpNoBody("GET",url.getAsString(),resp);
    if (resp.get_StatusCode() == 0) {
        System.out.println("No HTTP response from Twilio.");
        return;
        }

    boolean parsed = reply.Load(resp.bodyStr());
    if ((success != true) || (resp.get_StatusCode() != 200)) {
        System.out.println("Twilio returned HTTP " + resp.get_StatusCode());
        if ((parsed == true) && (reply.JsonTypeOf("code") == 2)) {
            System.out.println("Twilio error: " + reply.IntOf("code") + "  " + reply.stringOf("message"));
            }

        return;
        }

    if (parsed != true) {
        System.out.println("Expected a JSON response from Twilio.");
        return;
        }

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

    if (reply.BoolOf("valid") != true) {
        System.out.println("The number is invalid for the specified country.");
        int i = 0;
        while ((i < reply.SizeOfArray("validation_errors"))) {
            reply.put_I(i);
            System.out.println(reply.stringOf("validation_errors[i]"));
            i = i+1;
            }

        return;
        }

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

    System.out.println("E.164: " + reply.stringOf("phone_number"));
    System.out.println("National format: " + reply.stringOf("national_format"));
  }
}