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

Unicode C
#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkStringBuilderW number;
    BOOL encoded;
    HCkStringBuilderW url;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    BOOL parsed;
    int i;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Load an API key for the Twilio account from private application configuration.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putBasicAuth(http,TRUE);
    CkHttpW_putLogin(http,L"YOUR_API_KEY_SID");
    CkHttpW_putPassword(http,L"YOUR_API_KEY_SECRET");

    //  The phone number is one URL path segment. Percent-encode spaces and any leading +.
    number = CkStringBuilderW_Create();
    CkStringBuilderW_Append(number,L"020 7946 0018");
    encoded = CkStringBuilderW_Encode(number,L"url_rfc3986",L"utf-8");
    if (encoded != TRUE) {
        wprintf(L"Could not encode the phone number.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        return;
    }

    url = CkStringBuilderW_Create();
    CkStringBuilderW_Append(url,L"https://lookups.twilio.com/v2/PhoneNumbers/");
    CkStringBuilderW_Append(url,CkStringBuilderW_getAsString(number));
    CkStringBuilderW_Append(url,L"?CountryCode=GB");
    resp = CkHttpResponseW_Create();
    reply = CkJsonObjectW_Create();

    success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"No HTTP response from Twilio.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) != 200)) {
        wprintf(L"Twilio returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        if ((parsed == TRUE) && (CkJsonObjectW_JsonTypeOf(reply,L"code") == 2)) {
            wprintf(L"Twilio error: %d  %s\n",CkJsonObjectW_IntOf(reply,L"code"),CkJsonObjectW_stringOf(reply,L"message"));
        }

        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (parsed != TRUE) {
        wprintf(L"Expected a JSON response from Twilio.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_JsonTypeOf(reply,L"valid") != 5) {
        wprintf(L"The lookup response is missing the validity flag.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_BoolOf(reply,L"valid") != TRUE) {
        wprintf(L"The number is invalid for the specified country.\n");
        i = 0;
        while ((i < CkJsonObjectW_SizeOfArray(reply,L"validation_errors"))) {
            CkJsonObjectW_putI(reply,i);
            wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"validation_errors[i]"));
            i = i + 1;
        }

        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (CkJsonObjectW_JsonTypeOf(reply,L"phone_number") != 1) {
        wprintf(L"The lookup response is missing the E.164 number.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(number);
        CkStringBuilderW_Dispose(url);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    wprintf(L"E.164: %s\n",CkJsonObjectW_stringOf(reply,L"phone_number"));
    wprintf(L"National format: %s\n",CkJsonObjectW_stringOf(reply,L"national_format"));


    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(number);
    CkStringBuilderW_Dispose(url);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);

    }