Skip to content

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.

1 creditValidateCSV bulkMCP
POST/v1/phone-validation
{
  "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"
  }
}
[01/Response]

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.
[02/Capabilities]

What Phone Validation does

01

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.

02

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.

03

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.

04

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.

[03/Try it]

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.

POST /v1/phone-validation1 credit

US and Canada get carrier and DNC data. Other countries get format, country and line type.

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

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)
[05/Use cases]

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.

[06/Cost]

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
PlanPer 1,000 creditsPer 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
[07/FAQ]

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.

[ Validate ][ Enrich ]
[Get started]

Run Phone Validation on your own data

Starter is $29 a month for 6,000 credits, enough for 6,000 lookups a month.

[ Screen ][ Scrape ]