USA phone validation API: carrier look-up, line type, portability status, geo, timezone, and routing

How it works

Simply send a GET request to the endpoint with this data:

1. “phone” — required, multiple formats supported: 8182925409, +18182925409, +1 (818) 2925409, etc.
2. “ip” — optional, provide it to get geoIP data.

Requested numbers are checked against the latest (real-time) carrier records in the United States. In response, you get a handy JSON with appended information:

• Line type — you will know if a number is invalid, mobile or landline.
• Carrier DIP — carrier name and identifier code.
• GeoIP — provide an IP with your request and get precise timezone information.
• Location data — when IP is not supplied, you will receive geo and timezone data based on the area code of the phone you provided.
• Routing information — local routing number, the most accurate information used for calls or SMS routing.
• Portability status — up-to-date number portability status.

Response Example:

{
  "input": {
    "phone_number": "8182925409",
    "date": "2023-10-01T19:28:02.000Z"
  },
  "validation_result": {
    "valid_mobile": true,
    "valid_landline": false
  },
  "nanp": {
    "line_type": "mobile"
  },
  "carrier_data": {
    "lookup_result": "success",
    "carrier": "AT&T Mobility",
    "line_type": "mobile",
    "line_sub_type": "WIRELESS",
    "ported": false,
    "lrn": "8182925409",
    "ocn": "6010"
  },
  "geo": {
    "source": "area-code",
    "country": "US",
    "state": "CA",
    "city": "agoura hills"
  },
  "timezone": {
    "tz": "America/Los_Angeles",
    "offset": 8
  }
}

> Tags: NPAC, LRN, OCN, Carrier Dip, GeoIP, NANP, NPA NXX, Timezone, Portability, Line Type, Location