Testing SIM Swap with Magic Numbers

(warning)

Warning

Please review the Magic Numbers for Lookup and use your testing credentials for the correct Region when testing phone numbers. If you use your production credentials then the phone numbers do not display the correct responses shown below.

Note: Your testing credentials are region specific so make sure you have selected the region you want to test in the top right corner of the Auth Tokens page of your Console before testing phone numbers.

SIM Swap Magic Numbers

These phone numbers have simulated information for the following inputs which is for testing the SIM Swap feature. Testing SIM Swap with Magic Numbers works just like SIM Swap in Production and only requires you to submit the phone number with your query. Note: These phone numbers are examples only and do not include real time data.

Below are the Magic Numbers for SIM Swap, along with their Inputs/Outputs:

These phone number examples show the inputs (phone numbers) and their outputs (LastSimSwapDate, SwappedPeriod and SwappedinPeriod).

Phone Number	LastSimSwapDate	SwappedPeriod	SwappedInPeriod
+12345678900	null	PT48H	FALSE
+441234567890	"2018-07-25T11:47:40Z"	PT48H	FALSE
+491534567890	"2018-07-25T11:47:40Z"	PT48H	FALSE
+3933444567890	null	PT48H	FALSE
+31223456780	"2018-07-25T11:47:40Z"	PT48H	FALSE
+34712345670	"2018-07-25T11:47:40Z"	PT48H	FALSE
+551234567890	null	PT48H	FALSE
+573394567890	null	PT48H	FALSE
+12345678904	null	PT48H	TRUE
+441234567891	"2020-04-27T10:18:50Z"	PT48H	TRUE
+491534567891	"2020-04-27T10:18:50Z"	PT48H	TRUE
+3933444567891	null	PT48H	TRUE
+31223456781	"2020-04-27T10:18:50Z"	PT48H	TRUE
+34712345671	"2020-04-27T10:18:50Z"	PT48H	TRUE
+551234567891	null	PT48H	TRUE
+573394567891	null	PT48H	TRUE

These phone number examples show different types of errors when using SIM Swap.

Phone Number	Error Code
+12345678905	60004
+12345678906	60005
+12345678907	60006
+12345678909	60008
+12345678910	60601
+12345678911	60606
+12345678912	60607
+12345678913	60608
+12345678914	60614
+12345678915	60619
+12345678916	60620

SIM Swap Lookup

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function fetchPhoneNumber() {
11  const phoneNumber = await client.lookups.v2
12    .phoneNumbers("+447772000001")
13    .fetch({ fields: "sim_swap" });
14
15  console.log(phoneNumber.simSwap);
16}
17
18fetchPhoneNumber();

Output

1{
2  "calling_country_code": "44",
3  "country_code": "GB",
4  "phone_number": "+447772000001",
5  "national_format": "07772 000001",
6  "valid": true,
7  "validation_errors": null,
8  "caller_name": null,
9  "sim_swap": {
10    "last_sim_swap": {
11      "last_sim_swap_date": "2020-04-27T10:18:50Z",
12      "swapped_period": "PT48H",
13      "swapped_in_period": true
14    },
15    "carrier_name": "Vodafone UK",
16    "mobile_country_code": "276",
17    "mobile_network_code": "02",
18    "error_code": null
19  },
20  "call_forwarding": null,
21  "line_status": null,
22  "line_type_intelligence": null,
23  "identity_match": null,
24  "reassigned_number": null,
25  "sms_pumping_risk": null,
26  "phone_number_quality_score": null,
27  "pre_fill": null,
28  "url": "https://lookups.twilio.com/v2/PhoneNumbers/+447772000001"
29}