US & Canada Phone Validator — Carrier, Line Type, Litigator Scrub & Geo-IP

Bulk-verify US & Canada phone numbers with real, live carrier data — not offline format checks. Paste a list of numbers and get back validity, line type, current carrier, deliverability, ported status, geolocation, and optional TCPA litigator scrub and landline-SMS routing. Optionally add an IP to any number for IP↔phone geolocation matching, included with the lookup.

Built for lead validation, CRM hygiene, fraud screening, SMS/voice campaign prep, and TCPA compliance.

⚡ Backed by a validation network that has served 600M+ requests.

Why this actor

Most phone actors just wrap Google's offline libphonenumber — which returns blank carrier for US/Canada because of number portability. This actor hits live carrier databases, so you get the current carrier (portability-aware), real line type, and deliverability that offline tools can't provide.

• ✅ Real US/CA carrier & line type (mobile / landline / VoIP) — current, not carrier-at-issuance
• ✅ Deliverability — knows deactivated, ported, and undeliverable numbers
• 📍 Built-in geo-IP — add an IP and get IP↔phone geo match (country, state, city, metro, timezone), included with every lookup (not a separate add-on)
• 🛡️ TCPA litigator scrub — flag known TCPA litigators & serial plaintiffs from industry-leading data
• 📩 Landline-SMS lookup — detect text-enabled landlines and their messaging provider
• 🔁 Auto-dedup — one lookup per unique number (or phone+IP pair)
• 📦 Bulk-native — one run handles a handful or hundreds of thousands of numbers

Geo-IP enrichment 📍

Add an IP after any number — phone,ip — and the result includes the IP validation (ipResult) plus full IP-derived geolocation (geoCountry, geoState, geoCity, geoMetro, timezone, tzOffset, with geoSource: ip). It works for IPv4 and IPv6, and it's included with the base lookup — not a separate add-on. Perfect for fraud screening — compare where the phone is registered against where the IP resolves to catch mismatches at signup.

TCPA litigator scrub 🛡️

Turn on litigator scrub and every number is checked against a continuously-updated database of known TCPA litigators and serial plaintiffs — the professional filers who seed their numbers into lead lists and turn a single call or text into a $500–$1,500 statutory claim (and a class action from there). Flagged rows come back with litigator, litigator_type, and litigator_name, so you can suppress them before you dial or send — while keeping every clean number you can legitimately contact.

The list isn't ours to guess at: it's sourced from industry-leading litigation-data systems — the same caliber of data the largest TCPA-compliance platforms run on — matched against real case records and refreshed continuously. At one extra credit per number, it's protection that costs a rounding error next to a single claim.

Pair it with line type + deliverability for a complete pre-send pass: drop litigators, skip deactivated/undeliverable numbers, and route landlines correctly — in one run.

Input

• Phone numbers — one per line, any format (E.164, national, dashes, parentheses). Append ,ip to a line for geo-IP enrichment on that row. Duplicates are removed automatically.
• TCPA litigator scrub — flag professional plaintiffs / serial litigators.
• Landline SMS lookup — detect text-enabled landlines: messaging provider, country, and whether the landline can receive texts.

{
  "phoneNumbers": [
    "6108095225, 172.56.29.234",
    "7047122446, 71.76.83.173",
    "5154945996, 172.56.12.168",
    "4157012311, 8.8.8.8"
  ],
  "litigatorFilter": true,
  "landlineSmsLookup": true
}

Output

One row per number written to the run's dataset (export as JSON, CSV, or Excel). Fields use the same native names as the CheckThatPhone API docs, so single-call and bulk results are identical.

Field	Description
subscriber	The number looked up
action	send / unsubscribe / error — the contact verdict
deliverable	Whether it's safe/possible to contact
reason	Explanation when not deliverable (e.g. deactivated)
deactivationDate	When the carrier deactivated it, if applicable
nanpType	mobile / landline / not-mobile
dipCarrier	Current carrier (portability-aware)
dipCarrierType / dipCarrierSubType	e.g. mobile / PCS, landline / RBOC
dipPorted / dipLrn / dipOcn	Portability + routing details
blackList	Known-bad flag
litigator / litigator_type / litigator_name	TCPA litigator scrub (add-on)
dipMessagingEnabled / dipMessagingProvider / dipMessagingCountryCode	Landline-SMS routing (add-on)
ipResult	IP validation (valid-v4 / valid-v6) — when an IP is supplied
geoCountry / geoState / geoCity / geoMetro	Geolocation (IP-derived when an IP is supplied, else area-code)
geoSource	ip or area-code
timezone / tzOffset	IANA timezone + UTC offset

Notes

• Coverage: United States & Canada (NANP). Non-NANP numbers are skipped.
• Scale: one run handles up to ~1M numbers; large lists may take a while — the run polls to completion on its own.
• Dedup: the same number with two different IPs is two distinct lookups (each is a separate geo check); the same number+IP twice is one.