Line type lookup API
Line type lookup API: mobile, landline or VoIP
Know whether a US or Canadian number is mobile, landline or VoIP before you text or call it. Every lookup returns three line-type fields for one credit: one from the numbering plan and two from a live carrier dip, so the answer follows the number after a port.
- US and Canadian numbers
- Mobile, landline, VoIP
- One credit per lookup
| Number | The lookup says | Do this |
|---|---|---|
| (415) 555-0102 | Mobile (PCS) | Text it |
| (202) 555-0118 | Landline (RBOC) | Call it |
| (305) 555-0133 | Landline that takes texts | Text it |
| (646) 555-0187 | VoIP (IPES), ported | Review |
Fictional 555 numbers. The third row needs the landline SMS lookup.
- 1B+ requests served by our validation network
- ~32% of numbers we look up are landline or VoIP
- ~7% of landlines we check can take a text
The three line-type fields
| Field | Values | What it tells you |
|---|---|---|
nanpType | "mobile", "landline", "not-mobile" | Line type per the North American Numbering Plan. The quickest mobile vs not-mobile split. |
dipCarrierType | "mobile", "landline", "invalid", "undefined" | Broad type of the carrier serving the number now, from the live carrier dip, so it follows the number after a port. |
dipCarrierSubType | WIRELESS, PCS, WRSL, ILEC, RBOC, CLEC, IPES and others | WIRELESS and PCS are mobile networks, WRSL is wireless resale (MVNO), ILEC, RBOC and CLEC are wireline carriers, and IPES (IP-Enabled Service) is VoIP. |
The docs list every sub-type code. Values are strings.
How mobile, landline and VoIP numbers look in a response
| Field | Mobile | Landline | VoIP |
|---|---|---|---|
nanpType | "mobile" | "landline" or "not-mobile" | "not-mobile" |
dipCarrierType | "mobile" | "landline" | "landline" |
dipCarrierSubType | "WIRELESS" or "PCS" | "ILEC", "RBOC" or "CLEC" | "IPES" |
action | "send" | "unsubscribe" | "unsubscribe" |
Two things to watch for
-
A landline reads "unsubscribe"
actionis an SMS recommendation, so a working landline gets"unsubscribe"with the reason"Not a valid mobile number". It isn't disconnected. The landline SMS lookup finds the landlines that can take texts.action=unsubscribereason -
VoIP can look like a landline
A VoIP carrier can report
dipCarrierType: "landline". When VoIP matters to you, branch on the sub-type instead.dipCarrierSubType=IPES
Example request and response
The response for a wireline (RBOC) landline. Field names and formats match the live API.
Request
curl --request POST \
--url 'https://api.checkthatphone.com/v1/lookup' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{"phone": "202-555-0118"}' credits_used: 1 is the whole cost of this call, carrier and porting status included.
Highlighted fields in the response: action, reason, nanpType, dipCarrierSubType, dipCarrierType.
{
"success": true,
"credits_used": 1,
"data": {
"subscriber": "2025550118",
"optDate": "2026-10-03T15:11:47.902Z",
"action": "unsubscribe",
"deliverable": "false",
"reason": "Not a valid mobile number",
"nanpType": "not-mobile",
"blackList": "false",
"dip": "success",
"dipLrn": "2025550118",
"dipPorted": "false",
"dipOcn": "9211",
"dipCarrier": "Verizon",
"dipCarrierSubType": "RBOC",
"dipCarrierType": "landline",
"geoState": "DC",
"geoCity": "washington",
"geoCountry": "US",
"geoSource": "area-code",
"timezone": "America/New_York",
"tzOffset": 5,
"error": "false"
}
} What to do with line type
- Pick the channel Sales lead validation Mobile numbers can go text-first. Landlines get a call, or a landline SMS check first.
- Clean SMS lists Contact list hygiene Numbers that come back "unsubscribe" with "Not a valid mobile number" aren't SMS-eligible.
- Score signups KYC phone verification A VoIP number (
IPES) that was also ported is a strong fraud signal at signup. - Whole lists Bulk phone validation Upload a CSV and get the same line-type fields on every row.
How this compares with other line-type APIs
Some providers return finer categories. Twilio's Line Type Intelligence, for example, separates fixed and non-fixed VoIP and labels toll-free, premium and other number types, for numbers worldwide (Twilio docs, checked October 2026).
We cover US and Canadian numbers only and don't split fixed from non-fixed VoIP. In exchange, the same credit includes the carrier, porting status, deliverability and location. See the full CheckThatPhone vs Twilio Lookup comparison.
Pricing
Line type is included in every lookup: one credit, no separate fee.
- Free $0/mo 500 lookups included Hard cap, no overage
- 1K $5/mo 1,000 lookups included Then $0.005 each
- 10K $30/mo 10,000 lookups included Then $0.003 each
- 100K $100/mo 100,000 lookups included Then $0.001 each
- 500K $450/mo 500,000 lookups included Then $0.0009 each
Failed lookups are free. Annual billing is 15% off. Above 500,000 lookups a month, ask for a volume quote. Every detail is on the pricing page.
Line type lookup: common questions
How do I check if a phone number is mobile or landline?
Send it to POST /v1/lookup and read nanpType ("mobile", "landline" or "not-mobile") and dipCarrierType ("mobile" or "landline" for valid numbers). Both come back on every lookup for one credit.
Can the API detect VoIP numbers?
Yes. VoIP carriers return dipCarrierSubType: "IPES" (IP-Enabled Service). Branch on the sub-type, because a VoIP carrier can report dipCarrierType as "landline". We do not split fixed and non-fixed VoIP.
Can a landline receive text messages?
Some can. About 7% of landlines we check are SMS-capable. Turn on the landline SMS lookup (+1 credit, charged only on landlines) to find them.
Is line type included in the price?
Yes. Line type comes with every lookup at one credit, alongside carrier, porting, deliverability and location. There is no separate line-type fee.
Sort your list by line type
The Free plan includes 500 lookups a month, hard-capped. Paid plans start at $5 a month.