Live demo · 3 credits per lookup

Extended Lookup: Carrier Context

Everything in the standard lookup, plus the full identity of the carrier operating the number's block: OCN and carrier class, corporate holding company, line-type utilization codes, portability, and the wholesale-hosted flag. The per-number answer layer for suppression and routing.

Carrier context · billed in credits per lookup

Test with sample phone numbers

Extended US phone numbers

v1-get-phone-details
{
  "loading": "..."
}
v1-get-phone-extra-detailspremium · 3 credits
{
  "loading": "..."
}

Operating carrier identity

The OCN serving the number block, its carrier class (WIRELESS, CLEC, RBOC, ILEC, IPES, PCS, WRSL), common name, and DBA.

Corporate family

The holding company behind the operator — group a "New Cingular" block and a "Cricket-era" block under AT&T Inc without guesswork.

Wholesale-hosted flag

isWholesaleHosted marks blocks operated by wholesale and reseller carriers (Onvoy, Bandwidth.com, Neutral Tandem, Peerless, Inteliquent, iBasis, Voxbeam, and WRSL OCNs) — where MVNO SIMs, VoIP apps, and second-number services concentrate.

Line-type utilization

The raw ltype and ocnCategory codes behind the resolved type (MOBILE / VOIP / FIXED_LINE / PAGER) so your rules can go deeper than the summary field.

Block geography

Rate center, wire center, switch CLLI, ZIP, FIPS, county, CBSA/MSA, coordinates, and timezone for the block.

Portability signal

Whether the block participates in local number portability — your reminder that block data describes the original assignment.

What the response contains

Every field is block-resolved from the North American numbering data — the same answer for every caller, no per-line lookups, no provider hops.

FieldWhat it tells youExample
typeResolved line typeMOBILE
carrier / ocn / ocnTypeOperating carrier, its OCN, and carrier classAT&T · 4036 · WIRELESS
ocnHolding / ocnDbaCorporate holding company and DBAAT&T Inc
ltype / ocnCategoryRaw utilization and category codesC · W
isWholesaleHostedBlock operated by a wholesale or reseller carrierfalse
portableLocal number portability participationY
rateCenter / wireCenter / switchClliBlock geography and switchingLAPLACE · MANDEVILLE · MNVLLA20G07
county / cbsa / msa / latitude / longitudeReference geographySaint John the Baptist · 35380
olsonTz / utcOffsetTimezone for send-time decisionsAmerica/Chicago · -06:00

Built for suppression and routing

  • • Block or route VOIP and landline traffic before you spend on calls
  • • Send wholesale-hosted mobiles to review instead of the paid-dial queue
  • • Group offers by corporate family with the holding company field
  • • Time sends with block-level timezone

Where it stops

  • • Block-level data cannot name the MVNO brand behind a single number — that mapping lives per-line in portability records
  • • Ported numbers keep their original block assignment here
  • • For exchange-level risk (how reseller-heavy is the surrounding exchange?), step up to Full Data

Simple pricing: 3 credits per lookup

One credit is the standard lookup price. Extended answers cost 3 credits per number — billed only on successful lookups, with bulk CSV validation through the same pipeline. Volume plans and pay-as-you-go credits on the pricing page.

View pricing
Professional service • Instant setup