Lookup TiersNovember 13, 2026 · 10 min read

Extended Lookup: Carrier Context, OCN, and Wholesale-Hosted Flag at 3 Credits

The extended lookup answers the second question every phone workflow asks: not just is this number usable, but who is behind it. Three credits per number return the full identity of the carrier operating the number's block — the per-number answer layer for suppression, routing, and compliance.

What three credits buy

GET /v1-get-phone-extra-details (or the phone_lookup_npa_nxx MCP tool) resolves the number to its thousand-block and returns the block's registered carrier identity — a real response from a Manhattan AT&T block:

{
  "number": "+12122031567",
  "valid": true,
  "type": "MOBILE",
  "carrier": "AT&T",
  "ocn": "4036",
  "ocnType": "WIRELESS",
  "ocnCommonName": "AT&T",
  "ocnHolding": "AT&T Inc",
  "ltype": "C",
  "ocnCategory": "W",
  "portable": "Y",
  "isWholesaleHosted": false,
  "state": "NY",
  "rateCenterLong": "New York City Zone 1",
  "wireCenter": "NYC MANHATTAN-THOMAS ST",
  "geo": "New York City Zone 1, NY"
}

Field	What it tells you	Example
carrier / ocn / ocnType	Operating carrier, its OCN, and carrier class (WIRELESS, CLEC, RBOC, ILEC, IPES, PCS, WRSL)	AT&T · 4036 · WIRELESS
ocnHolding / ocnDba	Corporate family behind the operator	AT&T Inc
ltype / ocnCategory	Raw block utilization and category codes behind the resolved type	C · W
isWholesaleHosted	Block operated by a wholesale or reseller carrier	false
portable	Local number portability participation for the block	Y
rateCenter / wireCenter / switchClli	Block geography and switching equipment	NYC MANHATTAN-THOMAS ST
county / cbsa / msa / coordinates	Reference geography down to the parish level	Saint John the Baptist · 35380
olsonTz / utcOffset	Timezone for send-time and compliance windows	America/Chicago · -06:00

The wholesale-hosted flag, explained

isWholesaleHosted is true when the block is operated by a wholesale or enabling carrier — Onvoy, Bandwidth.com, Neutral Tandem, Peerless Network, Inteliquent, iBasis, Voxbeam — or by a wireless reseller (OCN class WRSL).

That matters because this is where MVNO SIMs, VoIP apps, and second-number services concentrate. On our dataset of 1,516,579 active blocks, the major MVNO brands own zero blocks themselves; their numbers live on host networks or on wholesale infrastructure. The flag marks the infrastructure segment where that traffic runs — an honest, block-level signal. It is not a per-number MVNO brand lookup, and it should drive review rules rather than blanket blocking.

What teams do with it

Suppression and dialer filtering. Line type blocks VOIP and landline traffic; the wholesale flag sends reseller-hosted mobiles to a review queue instead of the paid-dial path.
Offer targeting. The holding company groups numbers into corporate families — useful for account matching and regional offers.
Compliance evidence. OCN, wire center, and switch CLLI give an auditable record of what the network said about every number you dialed.
Send-time windows. Block-level timezone and rate center make local-hour scheduling exact.

Choosing between the tiers

1 credit

Standard lookup

Validity, line type, carrier hints, geo — the high-volume screening tier. Enough when the question is "is this number usable?"

Read the guide

6 credits

Full Data: Exchange Intelligence

Everything here, plus the exchange carrier mix and wholesale-share summary — when the question is about the exchange, not the number.

Read the guide

Try it and integrate it

curl "https://api.phone-check.app/v1-get-phone-extra-details?phone=%2B12122031567" \
  -H "accept: application/json" \
  -H "x-api-key: YOUR_API_KEY"

Extended Lookup — 3 credits per number

The full carrier-context package for per-number decisions. The live demo runs the same endpoint; bulk CSV validation applies it to whole lists through the same pipeline.

Open the live demo View pricing