Testing Identity Match with Magic Numbers

These phone numbers have simulated information for the following inputs which is for testing the Identity Match feature. To test Identity Match with Magic Numbers, you will be required to enter the phone number, FirstName, LastName, AddressLine1, City, State, PostalCode, NationalId, DateOfBirth and AddressCountryCode. In a production environment, you may only want to check a subset of these parameters, but when using Magic Numbers you will need to use all of the provided parameters.

*Note: The first magic number shows an example of a perfect match. The rest of these magic numbers are examples of when not all parameters match the data set. Please do not modify the input parameters because the output will not reflect your changes.

Below are the Phone Numbers for Identity Match, along with this Inputs/Outputs:

These phone number examples show different types of errors when using Identity Match.

Inputs/Outputs	Phone Number	FirstName	LastName	AddressLine1	City	State	PostalCode	NationalID	DateOfBirth	AddressCountryCode	Summary Score
Input	+12345678900	John	Twilion	123 Magic St	Owl City	CA	12345	123456789	20080313	US	null
Output	+12345678900	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	100
Input	+12345678901	Joh	Twil	123 Magic St	Owl City	CA	12345	123456789	20080313	US	null
Output	+12345678901	high_partial_match	high_partial_match	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	exact_match	100
Input	+12345678924	John	Magic	123 Magic St	Magic City	NY	M4 G15	901234567	20000425	US	null
Output	+12345678924	exact_match	no_match	exact_match	no_match	no_match	no_match	exact_match	no_match	no_match	80
Input	+12345678904	John	Twilion	456 Twilio Dr	Magic City	NY	M4 G15	901234567	20000425	GB	null
Output	+12345678904	exact_match	exact_match	no_match	no_match	no_match	no_match	no_match	no_match	no_match	40
Input	+12345678907	Charles	Twilion	456 Twilio Dr	Magic City	CA	45678	123456789	20000425	US	null
Output	+12345678907	no_match	exact_match	no_match	no_match	exact_match	no_match	no_match	no_match	exact_match	20
Input	+12345678912	Charles	Magic	456 Twilio Dr	Magic City	NY	45678	901234567	20000425	US	null
Output	+12345678912	no_match	no_match	no_match	no_match	no_match	no_match	no_match	no_match	no_match	0
Input	+12345678913	Charles	Magic	123 Owl Dr	Twilio City	CA	12345	234567891	19730403	US	null
Output	+12345678913	no_data_available	no_data_available	no_data_available	no_data_available	no_data_available	no_data_available	no_data_available	no_data_available	no_data_available	0

Value	Error Code
+12345678914	60001
+12345678915	60003
+12345678916	60006
+12345678917	60008
+12345678918	60607
+12345678919	60608
+12345678920	60617
+12345678921	60618

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_30// Download the helper library from https://www.twilio.com/docs/node/install
_30const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_30
_30// Find your Account SID and Auth Token at twilio.com/console
_30// and set the environment variables. See http://twil.io/secure
_30const accountSid = process.env.TWILIO_ACCOUNT_SID;
_30const authToken = process.env.TWILIO_AUTH_TOKEN;
_30const client = twilio(accountSid, authToken);
_30
_30async function fetchPhoneNumber() {
_30  const phoneNumber = await client.lookups.v2
_30    .phoneNumbers("+14159929960")
_30    .fetch({
_30      addressCountryCode: "US",
_30      addressLine1: "321 Main Street",
_30      addressLine2: "Suite 2",
_30      city: "New York",
_30      dateOfBirth: "19901214",
_30      fields: "identity_match",
_30      firstName: "John",
_30      lastName: "Doe",
_30      nationalId: "YZ3456883",
_30      postalCode: "10021",
_30      state: "NY",
_30    });
_30
_30  console.log(phoneNumber.callingCountryCode);
_30}
_30
_30fetchPhoneNumber();

Output


_32{
_32  "calling_country_code": "1",
_32  "country_code": "US",
_32  "phone_number": "+14159929960",
_32  "national_format": "(415) 992-9960",
_32  "valid": true,
_32  "validation_errors": [],
_32  "caller_name": null,
_32  "sim_swap": null,
_32  "call_forwarding": null,
_32  "line_status": null,
_32  "line_type_intelligence": null,
_32  "identity_match": {
_32    "first_name_match": "exact_match",
_32    "last_name_match": "high_partial_match",
_32    "address_lines_match": "no_match",
_32    "city_match": "no_match",
_32    "state_match": "high_partial_match",
_32    "postal_code_match": "no_data_available",
_32    "address_country_match": "exact_match",
_32    "national_id_match": "exact_match",
_32    "date_of_birth_match": "exact_match",
_32    "summary_score": 90,
_32    "error_code": null,
_32    "error_message": null
_32  },
_32  "reassigned_number": null,
_32  "sms_pumping_risk": null,
_32  "phone_number_quality_score": null,
_32  "pre_fill": null,
_32  "url": "https://lookups.twilio.com/v2/PhoneNumbers/+14159929960"
_32}

Testing Identity Match with Magic Numbers

Warning

Identity Match Magic Numbers

Identity Match Lookup