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.
- Line type
- mobile
- Original carrier
- T-Mobile USA, Inc.
- E.164
- +14155552671
- Local format
- (415) 555-2671
- Time zone
- America/Los_Angeles
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.
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.
Carrier
The carrier the number was issued to, named as the operator names itself.
Country and region
Where the number belongs, read from its prefix: the country, and the region or city where the plan defines one.
Clean formats
One E.164 string to store, plus the international and local forms to display or dial.
Time zone
The time zones the number’s range covers, so a call or a message arrives at a decent hour.
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.
basicWhether 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_typeBasic, 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_carrierLine type, plus the network the number is on today.
- The carrier the number is on today, ported or not
- Whether it was ported
line_statusCurrent 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.
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.
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"]){
"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" }
}
}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.
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_invalidThe phone number is not a valid number.
- phone_voipThe number is a VoIP line, easy to obtain anonymously.
- phone_non_personalThe number is a toll-free, premium-rate, shared-cost or pager line, not a personal one.
- phone_type_unknownThe line type could not be determined.
- geo_mismatchThe phone number’s country differs from the IP address’s.
About the phone check.
Does ProofTell send an SMS or call the number?
Does it tell me whether the phone is switched on right now?
Does the carrier follow a number that was ported?
Which formats can I send?
+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?
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?
Check your first number in a minute.
Create an account, take a sandbox key, make your first call in minutes.