Skip to content
ProofTell
Sign inSign up
Phone intelligence

Know the line behind the number.

Send any phone number and learn whether it can exist, what kind of line it is, which carrier issued it and where it belongs. 244 countries and territories, $2.50 per 1,000 numbers.

No SMS is sent and nothing reaches the phone.

Phone check
+1 415 555 2671
United States · San Francisco, CA
Valid
Line type
mobile
Original carrier
T-Mobile USA, Inc.
E.164
+14155552671
Local format
(415) 555-2671
Time zone
America/Los_Angeles
What comes back

Everything the number itself can tell you.

One request, one JSON object. The line type check runs on an engine our team has built and run since 2019.

Validity

The number is checked against the numbering plan of its country: length, prefix and range. A typo or an invention fails here.

valid

Line type

Mobile, fixed line, VoIP, toll-free and more. The difference between a customer you can reach and a line made to be thrown away.

line_type

Carrier

The carrier the number was issued to, named as the operator names itself.

original_carrier

Country and region

Where the number belongs, read from its prefix: the country, and the region or city where the plan defines one.

country_code · region

Clean formats

One E.164 string to store, plus the international and local forms to display or dial.

e164 · international_format · national_format

Time zone

The time zones the number’s range covers, so a call or a message arrives at a decent hour.

timezone
Levels

Four levels. Each includes the ones before it.

Basic and line type read what the number says about itself. Each level above asks more: the carrier it is on today and whether it is on the network right now.

Basic basic
Free

Whether the number can exist, read from its country’s numbering plan. By API, on a balance above zero.

  • Validity
  • Country and calling code
  • E.164, international and national formats
  • 244 countries and territories
Line type line_type
$2.50 per 1,000

Basic, plus what kind of line it is and who issued it, from the numbering plan. The default.

  • Line type: mobile, fixed line, VoIP, toll-free and more
  • The carrier the number was issued to
  • Region and time zone
Current carrier current_carrier
$8.00 per 1,000

Line type, plus the network the number is on today.

  • The carrier the number is on today, ported or not
  • Whether it was ported
Line status line_status
$16.00 per 1,000

Current carrier, plus whether the number is on the network right now: an HLR lookup.

  • Present on the mobile network now, or not
  • Why not, in words: switched off, absent, unknown subscriber, calls barred

Where line status doesn’t reach the network (in the United States, for one), or the line is fixed, you usually get the current carrier and pay $8.00 per 1,000, the current carrier level’s price; when only the network the number was issued to is known, only the line type is charged.

Send level with the number; without it, the lookup is line_type. Each price is the whole call, the line type included, and each part is charged when it returns a result: a level that can’t run for the number’s country costs nothing, and the line type’s answer still comes back. Basic costs nothing but, like every live call, needs a balance. A file runs its phone column at the level you pick from line type up; the risk score uses the line type.

The dashboard’s Coverage page shows where each level reaches, by country and carrier. A pt_test_ key answers every level with simulated results, free: +15005550009 is a ported number and +447700900005 is switched off.

Read the levels in the docs
For developers

One POST. One number.

Send the number in the request body, never in a URL, so it stays out of every log on the way. A pt_test_ key returns simulated results for documented numbers, free.

The values on the right are an illustration; the fields are the live ones.

Read the API reference
curl https://api.prooftell.com/v1/phone \
  -H "Authorization: Bearer $PROOFTELL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+14155552671"
  }'
const res = await fetch("https://api.prooftell.com/v1/phone", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PROOFTELL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone: "+14155552671",
  }),
})
const number = await res.json()
import os, requests

res = requests.post(
    "https://api.prooftell.com/v1/phone",
    headers={"Authorization": f"Bearer {os.environ['PROOFTELL_KEY']}"},
    json={
        "phone": "+14155552671",
    },
)
result = res.json()
print(result["valid"], result["line_type"])
Response
{
  "status": "success",
  "phone": "+14155552671",
  "valid": true,
  "line_type": "mobile",
  "region": "San Francisco, CA",
  "country": "United States",
  "country_code": "US",
  "country_prefix": "1",
  "international_format": "+1 415-555-2671",
  "national_format": "(415) 555-2671",
  "e164": "+14155552671",
  "original_carrier": "T-Mobile USA, Inc.",
  "timezone": ["America/Los_Angeles"],
  "geographical": false,
  "level": "line_type",
  "cost": "0.002500",
  "currency": "USD",
  "signals": {
    "line_type": { "status": "ok", "cost": "0.002500" }
  }
}
What it costs

Free, then from $2.50 per 1,000 numbers.

  • $0.0025 per number for the line type, taken from your dollar balance. No plan, no minimum volume. The basic check is free.
  • Charged when the number is judged, valid or not: an invalid number is a definitive answer.
  • Input that cannot be read as a phone number is answered and free. So are sandbox calls.
See the rate card
In the risk score

The tells a number gives away.

Sent to /v1/assess with an email or an IP, the line type check feeds the score. These are the reasons it can add:

  • phone_invalid
    The phone number is not a valid number.
  • phone_voip
    The number is a VoIP line, easy to obtain anonymously.
  • phone_non_personal
    The number is a toll-free, premium-rate, shared-cost or pager line, not a personal one.
  • phone_type_unknown
    The line type could not be determined.
  • geo_mismatch
    The phone number’s country differs from the IP address’s.
FAQ

About the phone check.

Does ProofTell send an SMS or call the number?
No. Nothing reaches the phone. ProofTell does not send one-time codes and does not sell phone numbers. It tells you what a number is, so you can decide before you spend a message on it.
Does it tell me whether the phone is switched on right now?
Yes, at the line status level (an HLR lookup), wherever it reaches the number’s mobile network: the answer says whether the number is on the network now and, when it isn’t, why (switched off, absent, unknown subscriber, calls barred). Where line status doesn’t reach the network (the United States among them), or the line is fixed, you usually get the carrier the number is on today and pay $8.00 per 1,000, the current carrier level’s price; when only the network the number was issued to is known, only the line type is charged. The dashboard’s Coverage page shows where line status reaches, by country and carrier. Basic and line type don’t ask the network.
Does the carrier follow a number that was ported?
From the current carrier level up, yes: the answer names the carrier the number is on today, where it is known, and says whether it was ported. The line type returns the carrier the number was issued to, so there a number moved to another network still shows its original carrier.
Which formats can I send?
E.164 is preferred (+447700900123). A number in national format works with a country hint, the two-letter ISO code of the country it should be read in.
Which countries are covered?
244 countries and territories. Validity, country and formats come back for every one. The line type comes back wherever the numbering plan tells mobile numbers from fixed lines; where both share the same ranges, it says so: fixed_line_or_mobile. Carrier names depend on what each national numbering plan publishes. The levels above line type don’t reach every network: the dashboard’s Coverage page shows where each one does, by country and carrier.
Can I check a whole list?
Yes, at any level from line type up. Upload a CSV or an Excel file from the dashboard, or through the API, and pick the level the phone column runs at. See bulk verification.

Check your first number in a minute.

Create an account, take a sandbox key, make your first call in minutes.