classify phone numbers with the Twilio Lookup v2 Line Type Intelligence package
domain: twilio.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
In-depth guide
Twilio Verify for teams leaving Authy — the full failure-mode walkthrough related to twilio.com, checked against official docs, with linked verified routes.
Steps
Call the Lookup v2 endpoint for the target phone number (E.164, full country code) with the line_type_intelligence field parameter.
Read the returned line type classification: mobile, landline, fixedVoip, nonFixedVoip, tollFree, personal, etc.
Use the classification to branch logic (e.g., skip SMS delivery attempts to landlines, flag VoIP numbers for higher fraud scrutiny).
For mobile numbers, also read carrier fields (mobile_country_code, mobile_network_code, carrier_name) when present.
Cache results where appropriate, since Line Type Intelligence is a paid, per-lookup query.
Known gotchas
Carrier fields (MCC/MNC/carrier name) come back null for several line types (personal, toll-free, premium, shared-cost, pager, voicemail, unknown) — a null carrier isn't a data-quality bug for those categories.
Canadian numbers require special account approval before Line Type Intelligence returns data — a lookup that works fine for US numbers can fail or return incomplete data for CA numbers without that approval.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?