Twilio Add-ons

// Download the helper library from https://www.twilio.com/docs/node/install
// Your Account Sid and Auth Token from twilio.com/console
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const authToken = 'your_auth_token';
const client = require('twilio')(accountSid, authToken);

client.lookups.phoneNumbers('+16502530000')
      .fetch({addOns: 'payfone_tcpa_compliance', addOnsData: {
           'payfone_tcpa_compliance.right_party_contacted_date': 20160101
       }})
      .then(phone_number => console.log(phone_number.callerName))
      .done();

// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Converters;
using Twilio.Rest.Lookups.V1;


class Program 
{
    static void Main(string[] args)
    {
        // Find your Account Sid and Token at twilio.com/console
        const string accountSid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string authToken = "your_auth_token";

        TwilioClient.Init(accountSid, authToken);

        var addOnsData = new Dictionary<string, Object>()
        {
            {"payfone_tcpa_compliance.right_party_contacted_date", 20160101}
        };

        var phoneNumber = PhoneNumberResource.Fetch(
            addOns: Promoter.ListOfOne("payfone_tcpa_compliance"),
            addOnsData: addOnsData,
            pathPhoneNumber: new Twilio.Types.PhoneNumber("+16502530000")
        );

        Console.WriteLine(phoneNumber.CallerName);
    }
}

<?php

// Update the path below to your autoload.php,
// see https://getcomposer.org/doc/01-basic-usage.md
require_once '/path/to/vendor/autoload.php';

use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$sid    = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$token  = "your_auth_token";
$twilio = new Client($sid, $token);

$phone_number = $twilio->lookups->v1->phoneNumbers("+16502530000")
                                    ->fetch(array(
                                                "addOns" => "payfone_tcpa_compliance",
                                                "addOnsData" => array(
                                                    "payfone_tcpa_compliance.right_party_contacted_date" => "20160101"
                                                )
                                            )
                                    );

print($phone_number->callerName);

# Download the helper library from https://www.twilio.com/docs/ruby/install
require 'rubygems'
require 'twilio-ruby'

# Your Account Sid and Auth Token from twilio.com/console
account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'
@client = Twilio::REST::Client.new(account_sid, auth_token)

phone_number = @client.lookups.phone_numbers('+16502530000')
  .fetch(add_ons: 'payfone_tcpa_compliance', add_ons_data: {
       'payfone_tcpa_compliance.right_party_contacted_date' => 20160101
   })

puts phone_number.caller_name

# Download the helper library from https://www.twilio.com/docs/python/install
from twilio.rest import Client


# Your Account Sid and Auth Token from twilio.com/console
account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'
client = Client(account_sid, auth_token)

phone_number = client.lookups.phone_numbers('+16502530000') \
    .fetch(add_ons='payfone_tcpa_compliance', add_ons_data={
         'payfone_tcpa_compliance.right_party_contacted_date': '20160101'
     })

print(phone_number.caller_name)

// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.converter.Promoter;
import com.twilio.rest.lookups.v1.PhoneNumber;

import java.util.HashMap;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String AUTH_TOKEN = "your_auth_token";

    public static void main(String[] args) {
        Twilio.init(ACCOUNT_SID, AUTH_TOKEN);
        PhoneNumber phoneNumber = PhoneNumber.fetcher(
                new com.twilio.type.PhoneNumber("+16502530000"))
            .setAddOns(Promoter.listOfOne("payfone_tcpa_compliance"))
            .setAddOnsData(
                new HashMap<String, Object>()
                {{
                    put("payfone_tcpa_compliance.right_party_contacted_date", 20160101);
                }})
            .fetch();

        System.out.println(phoneNumber.getCallerName());
    }
}

curl -X GET 'https://lookups.twilio.com/v1/PhoneNumbers/+16502530000?AddOns=payfone_tcpa_compliance&AddOns.payfone_tcpa_compliance.RightPartyContactedDate=20160101' \
-u ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token

$ curl -XGET https://lookups.twilio.com/v1/PhoneNumbers/+16502530000/?AddOns=provider_caller_identity \
    -u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'

{
  "status":"successful",
  "message":null,
  "code":null,
  "results":{
     "provider1_natural_tcpa_optout_detection":{
        "request_sid":"XR7b57f17eeae56053f034a8a819577e89",
        "status":"successful",
        "message":null,
        "code":null,
        "result":{
           "probability":0
        }
     },
     "provider2_language_insights":{
        "request_sid":"XR424628481f74b64b709950f1311b2235",
        "status":"successful",
        "message":null,
        "code":null,
        "result":{
           "status":"OK",
           "language":"english",
           "keywords":[
              {
                 "text":"Hi",
                 "relevance":"0.976891",
                 "sentiment":{
                    "type":"positive",
                    "score":"0.57102"
                 }
              },
              {
                 "text":"new add-ons",
                 "relevance":"0.935276",
                 "sentiment":{
                    "type":"positive",
                    "score":"0.415215"
                 }
              },
              {
                 "text":"Twilio",
                 "relevance":"0.728652",
                 "sentiment":{
                    "type":"positive",
                    "score":"0.415215"
                 }
              }
           ],
           "concepts":[

           ],
           "entities":[
              {
                 "type":"Company",
                 "relevance":"0.77978",
                 "sentiment":{
                    "type":"positive",
                    "score":"0.415215"
                 },
                 "count":"1",
                 "text":"Twilio",
                 "disambiguated":{
                    "name":"Twilio",
                    "dbpedia":"http://dbpedia.org/resource/Twilio",
                    "freebase":"http://rdf.freebase.com/ns/m.0h1bs6j"
                 }
              }
           ]
        }
     }
  }
}