Lead Scoring with Exchange Intelligence: How to Use Full Data
You can screen every number individually and still waste budget on a bad lead source. The problem is not the number — it is the exchange it lives in. An exchange saturated with wholesale and reseller blocks behaves very differently from a host-MNO exchange. Full Data returns that exchange intelligence in one call, so you can score entire lead sources before the dialer or SMS gateway spends a cent.
What Full Data returns
/v1-get-phone-full-details includes everything in extended carrier context plus two exchange-level fields: nxxCarrierMix (every carrier operating blocks in the exchange) and nxxSummary (total blocks, wholesale blocks, wholesale share, carrier count):
curl "https://api.phone-check.app/v1-get-phone-full-details?phone=%2B12013570123" \
-H "accept: application/json" \
-H "x-api-key: YOUR_API_KEY"
// Response (abridged)
{
"type": "VOIP",
"carrier": "Bandwidth.com",
"ocn": "118F",
"isWholesaleHosted": true,
"nxxCarrierMix": [
{ "carrier": "Bandwidth.com", "ocnType": "CLEC", "blocks": 4, "isWholesaleHosted": true },
{ "carrier": "CSC Voice", "ocnType": "IPES", "blocks": 4, "isWholesaleHosted": false },
{ "carrier": "Onvoy", "ocnType": "CLEC", "blocks": 3, "isWholesaleHosted": true }
],
"nxxSummary": {
"totalBlocks": 11,
"wholesaleBlocks": 7,
"wholesaleShare": 0.64,
"carrierCount": 3
}
}Scoring lead sources by wholesale share
The wholesaleShare field (0–1) is the single number that predicts churn risk. Here is a complete lead-scoring layer that consumes it:
// lead-scorer.ts — score lead sources by exchange risk
import { getPhoneFullDetails } from './phone-api';
interface ExchangeRisk {
risk: 'LOW' | 'MEDIUM' | 'HIGH';
action: 'ALLOW' | 'MONITOR' | 'REVIEW';
reason: string;
wholesaleShare: number;
}
function scoreExchange(r: FullDetailsResponse): ExchangeRisk {
const share = r.nxxSummary.wholesaleShare;
if (share >= 0.50) {
return {
risk: 'HIGH',
action: 'REVIEW',
reason: 'Exchange is majority wholesale/reseller — elevated churn and prepaid concentration',
wholesaleShare: share,
};
}
if (share >= 0.25) {
return {
risk: 'MEDIUM',
action: 'MONITOR',
reason: 'Moderate wholesale share — normal churn, standard cadence',
wholesaleShare: share,
};
}
return {
risk: 'LOW',
action: 'ALLOW',
reason: 'Host-MNO exchange — clean postpaid wireless behavior',
wholesaleShare: share,
};
}
// Batch-score a lead source and compute the average risk
async function scoreLeadSource(phones: string[]) {
const scores = await Promise.all(
phones.map(async (phone) => scoreExchange(await getPhoneFullDetails(phone)))
);
const avgShare = scores.reduce((s, x) => s + x.wholesaleShare, 0) / scores.length;
const highRisk = scores.filter((x) => x.risk === 'HIGH').length;
return {
source: 'your-lead-source-id',
avgWholesaleShare: avgShare.toFixed(3),
highRiskPct: ((highRisk / phones.length) * 100).toFixed(1) + '%',
recommendation: avgShare >= 0.35 ? 'REVIEW — reseller-heavy source' : 'CLEAN — standard cadence',
};
}Exchange-level audit trail
Every suppression decision should be reproducible. Full Data gives you the complete carrier composition of the exchange — enough to explain to a compliance team or regulator why a number was routed the way it was:
// Exchange audit — reproducible record for compliance
function auditExchange(r: FullDetailsResponse) {
return {
number: r.number,
exchange: `${r.npa}-${r.nxx}`,
summary: r.nxxSummary,
carriers: r.nxxCarrierMix.map((e) => ({
name: e.carrier,
class: e.ocnType,
blocks: e.blocks,
wholesale: e.isWholesaleHosted,
})),
decision: r.isWholesaleHosted ? 'REVIEW' : 'ALLOW',
timestamp: new Date().toISOString(),
};
}What the numbers tell you
- wholesaleShare ≥ 0.50 — majority reseller infrastructure. This exchange concentrates MVNO SIMs, VoIP apps, and second-number services. Elevated churn and prepaid behavior. Route to review or use a softer cadence.
- wholesaleShare 0.25–0.50 — moderate wholesale presence. Normal churn. Standard dialing cadence with normal monitoring.
- wholesaleShare < 0.25 — host-MNO exchange. Clean postpaid wireless behavior. Standard cadence, high confidence.
When extended is enough
For per-number suppression and routing, /v1-get-phone-extra-details (3 credits) returns OCN, holding company, wholesale flag, and line-type codes. Full Data at 6 credits earns its step when the question is about the exchange, not the number — list-risk scoring, exchange audits, and dialer cadence strategy.
Call Suppression with Extended Carrier Context
Build a real-time routing layer with OCN, holding company, and the wholesale-hosted flag.
Read the guideTry Full Data live
Run the full-data lookup on your own numbers and see the exchange carrier mix and wholesale-share summary in the response.
Open the demo