apyhub
Back
▣ DATA VALIDATION · GEOLOCATION

Phone Carrier Lookup API

What it does

The phone number lookup API returns what is known about a phone number: its carrier, geographic region, time zones, and number type. Send the number in the number query parameter and the response comes back as JSON.

One optional parameter handles ambiguous input. Set country when a number arrives in national format and you need it interpreted for a specific country. It defaults to US. The response contains the normalized number, plus carrier, region, timezones and number_type. Fields the service can resolve are filled in, and the rest come back as null, so treat them as optional in your code.

Support teams use it to route calls and messages by network. Growth teams run carrier lookup across contact lists before a campaign. Scheduling tools read timezones to pick a sending window, and signup flows read number_type to separate mobile numbers from landline and VoIP.

The phone number lookup API describes the number itself. To confirm a number is well formed before you look it up, run the Phone Validation API first and pass the E.164 result here.

It pairs with the IANA Timezone API when you need the full timezone list to match against, and with the All-in-One Verification API when a phone number is one signal in a wider fraud check. All three are callable by AI agents through ApyHub MCP.

GET
Look up carrier name, geographic region, and timezones for a phone number
https://api.eu.apyhub.com/dosvak/phone-carrier-lookup

QUICKSTART

GUIDE

Quickstart

Look up carrier details for a phone number by passing the required number query parameter.

curl -X GET "https://api.eu.apyhub.com/dosvak/phone-carrier-lookup?number=%2B14155552671" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: number (string), region (string or null), carrier (string or null), timezones (array of string), and number_type (string).

{
  "number": "+14155552671",
  "region": "California",
  "carrier": "AT&T",
  "timezones": ["America/Los_Angeles"],
  "number_type": "mobile"
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Looks up details for a phone number and returns a JSON object containing the number, its geographic region, carrier, timezones, and number type.

Query Parameter(s)

AttributeTypeDescription
numberStringPhone number to look up.
countryStringCountry code to use for lookup. Default: US.

Response

Returns a JSON object with number, region, carrier, timezones, and number_type fields. The region and carrier fields are nullable strings, timezones is an array of strings, and number_type is a string.

ParameterTypeDescription
numberStringThe phone number returned by the lookup.
regionStringGeographic region for the phone number, or null if unavailable.
carrierStringCarrier name for the phone number, or null if unavailable.
timezonesString ArrayTimezone names associated with the phone number.
number_typeStringThe phone number type returned by the lookup.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.