Phone validation API for carrier, line type and risk
Send a number, get back whether it is real, who carries it, whether it is mobile, landline or VoIP, and whether it is on the Do Not Call registry. One credit per lookup.
{
"success": true,
"data": {
"phone_number": "+15125550142",
"valid": true,
"line_type": "mobile",
"carrier": {
"name": "Example Wireless",
"ocn": "6010",
"lrn": "+15125550000",
"ported": true
},
"location": {
"city": "Austin",
"state": "TX",
"country": "US",
"timezone": "America/Chicago"
},
"dnc": {
"listed": false,
"dno": false
},
"risk": {
"level": "low",
"factors": []
}
},
"meta": {
"credits_used": 1,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}What you get back
The fields most teams branch on. The full response is in the sample on this page and in the API reference.
validValidityWhether the number is a real, assignable number in its numbering plan.line_typeLine typemobile, landline, voip, toll_free or unknown, so you know if it can receive SMS.carrier.nameCurrent carrierThe carrier serving the number today, after any porting.carrier.portedPortingWhether the number moved from the carrier that was first assigned it.dnc.listedDo Not CallWhether a US number appears on the National Do Not Call registry.risk.levelRisk levellow, medium or high, with the factors that produced it.locationLocationCity, state, country and time zone tied to the number's rate center.What Phone Validation does
Carrier and porting data
US and Canadian lookups resolve the current carrier, OCN and LRN, and tell you whether the number was ported. That is the difference between routing an SMS correctly and paying for one that never lands.
Line type you can route on
Every result is labeled mobile, landline, VoIP or toll-free. Send texts only to mobiles, dial landlines, and decide for yourself how much to trust a VoIP number at signup.
Compliance flags in the same call
US numbers come back with National Do Not Call status and a Do Not Originate flag. You see them before you dial, without a second vendor or a second request.
A risk level with reasons
The response carries a low, medium or high risk level and the factors behind it, such as VoIP line type or recent porting. You get the inputs, so you can apply your own threshold.
See the response before you sign up
Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.
Fill in the field and run the lookup to see what comes back.
One POST request
Send JSON with a Bearer key. The same key works for all 79 products.
curl -X POST https://api.1lookup.dev/v1/phone-validation \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone_number":"+15125550142"}'- Endpoint
POST /v1/phone-validation- Base URL
https://api.1lookup.dev- Request
phone_number- Price
- 1 credit
- Coverage
- US & Canada in depth, 200+ countries for format and type
- Bulk
- CSV upload and bulk API
- Cache
- Repeats within 7 days are free
- Also via
- Dashboard and MCP server (run_lookup)
What teams use it for
Clean a list before an SMS campaign
Upload the list as a CSV, keep the valid mobiles, drop the landlines and invalid numbers, and stop paying your SMS provider for messages that cannot be delivered.
Verify numbers at signup
Call the API when a user submits a number. Reject impossible numbers on the spot and send higher-risk line types to an extra verification step.
Keep a CRM dialable
Re-check contacts on a schedule. Numbers get ported and reassigned every day, and a monthly pass keeps your reps from dialing dead lines.
Carrier, porting and DNC fields are available for US and Canadian numbers. Other countries return format, country and line type.
1 credit
Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.
See pricing| Plan | Per 1,000 credits | Per 1,000 lookups |
|---|---|---|
| Starter $29/mo | $4.83 | $4.83 |
| Growth $99/mo | $3.96 | $3.96 |
| Pro $299/mo | $3.32 | $3.32 |
| Scale $799/mo | $2.66 | $2.66 |
Phone Validation questions
What does phone validation check?
It checks that the number is correctly formatted and assignable, then resolves its carrier, line type, porting status and location. US numbers also return Do Not Call status and a risk level.
Which countries are covered?
US and Canadian numbers return the full record, including carrier, porting and DNC. Numbers in 200+ other countries return format validity, country and line type. For live network status on international mobiles, use HLR Lookup.
How much does a lookup cost?
One credit per number. Repeat lookups of the same number within 7 days are served from cache at no charge, and requests that fail on our side are never billed.
Can I validate a whole list?
Yes. Upload a CSV in the dashboard or submit a job to the bulk API. Results come back as a file with your original columns plus the validation fields, and a webhook fires when the job is done.
Does a clean result make my calls TCPA compliant?
No single lookup does that. The DNC and line type fields give you inputs your compliance process needs, but consent and calling rules remain your responsibility. Talk to counsel about your specific program.
Related products
Run Phone Validation on your own data
Starter is $29 a month for 6,000 credits, enough for 6,000 lookups a month.