Search by task, endpoint, field, or error.

Carrier Lookup API

Who serves a number: carrier, line type, and burner.

Who serves a phone number, from a live network dip. Pass +12127365000 and get back the carrier, the real line type including voip, a burner flag when the carrier is a known burner number app. The issuing city and state are included in the same lookup unit when available.

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

LookupCopy link

GET /carrier/{number}API Explorer ↗

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

Parameters

numberstring · path · required

Phone number (E.164 preferred)

countrystring · query · optional

Default region for national formats without a leading +

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.carrier("+12127365000");
console.log(result);
Example response
{
  "phone": "+12127365000",
  "valid": true,
  "country": "US",
  "type": "voip",
  "carrier": "Sinch Voice",
  "burner": false,
  "city": null,
  "state": "NY",
  "state_name": "New York"
}
Open in API Explorer ↗

Response fields

phoneLink to phonestring or null
Normalized number (+ country code, no spaces), or null if invalid
validLink to validboolean
Number is valid
countryLink to countrystring or null
ISO 3166-1 alpha-2 country
typeLink to typestring or null
mobile | landline | voip | toll_free | unknown. Uses a recognized provider type when available; otherwise retains the numbering-plan type
carrierLink to carrierstring or null
Carrier display name, else null
burnerLink to burnerboolean or null
true when the carrier is a known burner app. null if we do not know the carrier
cityLink to citystring or null
City where the number block was issued (not live location). Gazetteer name when known, readable expansion otherwise
stateLink to statestring or null
State/province code from the area code (NANP), else null
state_nameLink to state_namestring or null
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.

Included dataCopy link

Recorded issuing location, included in the same carrier lookup. Included in the same lookup, with no additional charge.

Paid plan fields