Twilio Add-ons

// Get your Account SID and Auth Token from twilio.com/console
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const authToken = 'your_auth_token';

// Download the Node.js helper library from twilio.com/docs/libraries/node
const client = require('twilio')(accountSid, authToken);

client.lookups.v1
  .phoneNumbers('+16502530000')
  .fetch({
    addOns: 'payfone_tcpa_compliance',
    addOnsData: {
      'payfone_tcpa_compliance.RightPartyContactedDate': '20160101',
    },
  })
  .then(number => console.log(number.addOns));

// Download the C# helper library from twilio.com/docs/libraries/csharp
using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Rest.Lookups.V1;
using Twilio.Types;

namespace Example
{
    class MainClass
    {
        public static void Main(string[] args)
        {
            // Get your Account SID and Auth Token from twilio.com/console
            const string accountSid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
            const string authToken = "your_auth_token";

            TwilioClient.Init(accountSid, authToken);

            var addOns = new List<string> { "payfone_tcpa_compliance" };
            var addOnsData = new Dictionary<string, object>
            {
                { "payfone_tcpa_compliance.RightPartyContactedDate", "20160101" }
            };

            var phoneNumberFetcher =
                PhoneNumberResource.Fetcher(new PhoneNumber("+16502530000"));
            phoneNumberFetcher.addOns = addOns;
            phoneNumberFetcher.addOnsData = addOnsData;

            var number = phoneNumberFetcher.Fetch();
            Console.WriteLine(number.addOns);
        }
    }
}

<?php

// Download the PHP helper library from twilio.com/docs/libraries/php
require_once '/path/to/vendor/autoload.php'; // Loads the library

use Twilio\Rest\Client;

// Get your Account SID and Auth Token from twilio.com/console
$accountSid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$authToken = "your_auth_token";

$client = new Client($accountSid, $authToken);

$number = $client->lookups
    ->phoneNumbers("+16502530000")
    ->fetch(
        [
            "addOns" => "payfone_tcpa_compliance",
            "addOnsData" => [
                "payfone_tcpa_compliance.RightPartyContactedDate" => "20160101"
            ]
        ]
      );

print_r($number->addOns);

# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account SID and Auth Token from twilio.com/console
account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'

# Initialize Twilio Client
@client = Twilio::REST::Client.new(account_sid, auth_token)

number = @client.lookups.v1
                .phone_numbers('+16502530000') \
                .fetch(add_ons: 'payfone_tcpa_compliance',
                       add_ons_data: {
                         'payfone_tcpa_compliance.RightPartyContactedDate' => '20160101'
                       })

print(number.add_ons)

# Download the Python helper library from twilio.com/docs/libraries/python
from twilio.rest import Client


# Get your Account SID and Auth Token from twilio.com/console
account_sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
auth_token = "your_auth_token"
client = Client(account_sid, auth_token)

number = client.lookups \
               .phone_numbers("+16502530000") \
               .fetch(add_ons="payfone_tcpa_compliance",
                      add_ons_data={"payfone_tcpa_compliance.RightPartyContactedDate": "20160101"})

print(number.add_ons)

// Download the Java helper library from twilio.com/docs/libraries/java
import com.twilio.Twilio;
import com.twilio.rest.lookups.v1.PhoneNumber;

import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class Example {

    // Get your Account SID and Auth Token from 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);

        List<String> addOns = Arrays.asList("payfone_tcpa_compliance");
        Map<String, Object> addOnsData = new HashMap<String, Object>() {{
            put("payfone_tcpa_compliance.RightPartyContactedDate", "20160101");
        }};

        PhoneNumber number = PhoneNumber
                .fetcher(new com.twilio.type.PhoneNumber("+15108675310"))
                .setAddOns(addOns)
                .setAddOnsData(addOnsData)
                .fetch();

        System.out.println(number.getAddOns());
    }
}

$ 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"
                 }
              }
           ]
        }
     }
  }
}