Integration guide · Phone system

Phone validation for Twilio

Short answer

Twilio is a cloud communications platform for building calling and messaging into apps. TrueSearch does not have a native Twilio app. You can check the phone numbers you work with in Twilio, using the TrueSearch API. Every number comes back marked valid or dead, mobile, landline or VoIP, with carrier.

Twilio also sells its own Lookup API. If you already use it, compare it against TrueSearch for your volume; see TrueSearch vs Twilio Lookup. TrueSearch vs Twilio Lookup.

Option 1: call the API from Twilio

Twilio Functions (serverless JavaScript) can call the TrueSearch API before you send a message or place a call, and Twilio Studio flows can use the Make HTTP Request widget.

Method POST to https://truesearch.app/api/business/scrub
Header x-api-key: ts_live_… (or Authorization: Bearer ts_live_…) and Content-Type: application/json
Body {"numbers": [...]} with up to 1,000 numbers in any format
Read rows[].valid, lineType, carrier and keep from the response

curl https://truesearch.app/api/business/scrub \
  -H "Content-Type: application/json" \
  -H "x-api-key: ts_live_…" \
  -d '{"numbers":["+1317XXXXXXX","(317) XXX-XXXX"]}'

{"summary":{"total":2,"keep":1,...},
 "rows":[{"input":"+1317XXXXXXX","e164":"+1317XXXXXXX","valid":true,
          "lineType":"mobile","carrier":"…","keep":true,"reason":"ok"}, …]}

What TrueSearch for Business does

Valid or dead (disconnected / not assigned)	Yes, every number
Line type: mobile, landline, VoIP, toll-free	Yes, every number
Carrier name	Yes, every number
Bulk upload (CSV or Excel)	Yes, results in about 30 seconds per 1,000 numbers
REST API	Yes (JSON, one API key)
Claude / ChatGPT / Cursor connector (MCP)	Yes
National or state Do Not Call check	No, not yet
Known TCPA litigator check	No, not yet
FCC Reassigned Numbers Database check	No
Starting price	$97/month for 5,000 numbers, 7-day free trial
One-off list	$20 per 1,000 numbers, no subscription

Clean your list in 30 seconds

Upload a CSV or Excel file. Get back every number marked valid or dead, mobile, landline or VoIP, with carrier.

Start 7-day free trial →Free carrier lookup

Starter: $97/month for 5,000 numbers after the 7-day trial. Cancel anytime.

Questions

Is there a native TrueSearch app for Twilio?

No. TrueSearch does not have a native Twilio app and is not affiliated with Twilio. You connect them yourself with the TrueSearch API, as described on this page.

What comes back for each number?

Whether the number is valid, its line type (mobile, landline, VoIP or toll-free), its carrier, and keep: true when the number is valid and mobile. Rows that are not kept include the reason, such as landline, voip or invalid.

How many numbers per API call?

Up to 1,000 numbers per request. Each number with a valid format uses one credit from your plan.

Does TrueSearch check Do Not Call or litigator lists?

No, not yet. Run DNC and litigator checks separately where they apply to your calls and texts.

Can I try it first?

Yes. The Starter plan has a 7-day free trial that covers 250 numbers. After the trial it is $97/month for 5,000 numbers, cancel anytime. A one-off list is $20 per 1,000 numbers.

Twilio is a trademark of its owner, used here only to identify the product. TrueSearch is not affiliated with, endorsed by or a partner of Twilio. This guide is general information, not legal advice. TrueSearch for Business checks validity, line type and carrier from licensed telecom data. It does not check the National Do Not Call Registry, state DNC lists or the FCC Reassigned Numbers Database. Not a consumer reporting agency; not for FCRA purposes.