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
Pick the channel
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

FieldValuesWhat 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.
dipCarrierSubTypeWIRELESS, PCS, WRSL, ILEC, RBOC, CLEC, IPES and othersWIRELESS 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

FieldMobileLandlineVoIP
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"

    action is 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

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.