Carrier Lookup API

Who serves a number: carrier, line type, ported.

Who serves a phone number, from a live network dip. Pass +13129457420 and get back the carrier, the real line type including voip, a burner flag when the carrier is a known burner number app, whether the number was ported (and when), and the city and state where the number was issued — not live location.

Junk answers valid: false as a 200, never a 404. Free syntax checks and formatting live on /phone, no unit spent.

Lookup

GET

api.parseapi.com/carrier/{number}

Carrier, line type, burner, ported, place. Optional ?country= (ISO2) for national formats

curl "https://api.parseapi.com/carrier/+13129457420" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "phone": "+13129457420",
  "valid": true,
  "country": "US",
  "type": "voip",
  "carrier": "Telnyx",
  "burner": false,
  "ported": true,
  "ported_date": "2017-10-20",
  "city": "Waukegan",
  "state": "IL",
  "state_name": "Illinois"
}

curl "https://api.parseapi.com/carrier/+14153755556" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "phone": "+14153755556",
  "valid": true,
  "country": "US",
  "type": "mobile",
  "carrier": "Verizon Wireless",
  "burner": false,
  "ported": false,
  "ported_date": null,
  "city": "San Francisco",
  "state": "CA",
  "state_name": "California"
}

curl "https://api.parseapi.com/carrier/555-0100" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "phone": null,
  "valid": false,
  "country": null
}

Response fields

phone: Normalized number (+ country code, no spaces), or null if invalid
valid: Number is valid
country: ISO 3166-1 alpha-2 country
type: mobile | landline | voip | toll_free | unknown
carrier: Carrier display name, else null
burner: true when the carrier is a known burner app. null if we do not know the carrier
ported: Number has moved carriers (NANP), null when unknown
ported_date: Date the number was ported, null when not ported
city: City where the number block was issued (not live location). Gazetteer name when known, readable expansion otherwise
state: State/province code from the area code (NANP), else null
state_name: State/province name from the area code (NANP), else null

Counts against your plan's monthly carrier allowance. Free includes 100. Each lookup on a valid number uses one. A repeat on the same number within a day serves from cache and still uses one.

Questions? Email