Practical GuideNovember 17, 2026 · 12 min read

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.

Related articles