nvNeuralVerge
Enrichment

US Phone Validation API — Carrier, Line Type & Owner

This is the deep check on a US number. It returns whether the number is valid, the carrier, the line type, whether it is prepaid, an activity score, a litigation-risk flag, and the owner records associated with it, each with its current addresses.

Example response
{
  "session_id": "6e12…",
  "kind": "phone_enrichment_us",
  "phone": "12069735100",
  "human": "Valid mobile number, active…",
  "machine": {
    "phone_number": "12069735100",
    "is_valid": true,
    "line_type": "mobile",
    "carrier": "…",
    "is_prepaid": false,
    "activity_score": 87,
    "is_litigator_risk": false,
    "country_code": "US",
    "owners": [
      {
        "name": "Jane Doe",
        "type": "person",
        "current_addresses": [
          { "city": "Austin", "state_code": "TX" }
        ]
      }
    ]
  },
  "total_points": 100
}
You send
A US phone number
You get back
Validity, carrier, line type, activity signals and owner records
Coverage
United States only.
Price
100 pts$100 per 1,000
100 points per number — $0.10 each. Only successful lookups are charged.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Calling and finding outNone up frontRegulatory exposureIn the United States the rules differ by line type, so this is the expensive way to learn
A carrier-lookup vendorA separate contract, usually with a minimum commitmentEnterprise pricingAnother silo, and often no owner data alongside the number data
NeuralVergeOne request, same key as every other source$0.10 per numberUnited States only, and it is the most expensive source in the catalog for a reason
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
phone_numberstringThe number that was checked.
is_validbooleanWhether the number is valid.
line_typestringMobile, landline or another type — the field that governs how you may contact it.
carrierstringThe carrier the number sits with.
is_prepaidbooleanWhether the line is prepaid.
activity_scorenumberHow active the number appears to be.
is_litigator_riskbooleanWhether the number is associated with a history of claims.
country_codestringCountry code and calling code for the number.
ownersarrayOwner records with names, type, age range where known, and current addresses.
warningsarrayAny warnings raised during the check.
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

US numbers are accepted with the leading country digit and no plus sign, as in the example. This is the only source in the catalog that returns carrier and line-type detail.

curl -X POST https://api.neuralverge.ai/functions/v1/run-phone-enrichment-us \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "12069735100" }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Screening before a dialling campaign

Separate mobiles from landlines, and drop the numbers flagged for claim history.

Validating a contact list

Remove dead numbers before they burn agent time.

Prioritising by activity

Work the numbers that are actually in use before the ones that are not.

Confirming ownership

Check the number belongs to who your record says it does.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

United States only.

Freshness

Checked at request time.

Handling

Contacting US phone numbers is regulated, and the rules differ by line type and by consent. This source gives you the facts to comply; the obligation stays with you. Nothing here is legal advice.

What it will not do
  • US numbers only — for the rest of the world use Phone enrichment.
  • It is the most expensive source in the catalog at 100 points per number, so screen a list before you run it.
  • A clear litigation-risk flag is a signal, not legal advice or a compliance sign-off.
FAQ

Questions, answered

Because United States rules on unsolicited contact differ between mobile and landline numbers. Knowing which you have before you dial is the point of running the check.

Related

Related sources

Try phone enrichment us on your own data

One request format across every source in the catalog.

Get started