LRN lookup: one number and optional inclusions

Send one LRN lookup with optional enhanced carrier details, messaging provider, CNAM and trust. See exact parameters and per-product costs.

How do I request only the LRN?

POST /api/v1/lrn with phone_number and lrn_only: true. This minimal mode overrides all inclusion flags. The normal response and the minimal response are different; choose the mode deliberately.

Can one request include more data?

Yes. On the single-number endpoint use include_enhanced_lrn, messaging_lookup, include_cnam and include_trust. Each selected product contributes its own per-number price. Spam/trust is one inclusion, requested with include_trust.

Request example

Illustrative request only. Use your own number and API key; live lookups may incur charges.

curl 'https://verirouteintel.com/api/v1/lrn' \
  -H "Authorization: Bearer $VRI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"phone_number":"13364086644","lrn_only":true}'

Continue with the right guide

Response Format

carrier_type preserves the returned carrier classification. Dashboard labels are simplified display categories. Read the carrier classification and CSV guide for code meanings and the limits of inferring VoIP versus landline.

Activation date: the lrn_activated_at field

Most lookup APIs tell you a number's current carrier. We also tell you when it last ported there. Every phone number is born on an original carrier; when it's ported, the lrn_activated_at timestamp records the date of that most recent port.

Example: a number issued by CenturyLink (Lumen) that the subscriber later ports to AT&T Wireless returns carrier: "AT&T Wireless" with an lrn_activated_at of the port date. A number that has never left its original carrier returns no lrn_activated_at (or its original activation date).

Use this timestamp as one input to porting-history review. It does not by itself establish a SIM swap, account takeover, or subscriber identity. Included free with every LRN lookup — no extra call, no extra charge. See the LRN Activation Date feature page.

Note: The lrn_activated_at field is optional and may not be present if the activation date is unavailable (e.g., a number that has never been ported, or where the carrier does not expose the date).

LRN-Only Mode (Fastest)

When lrn_only=true, the API returns only the LRN for maximum performance:

{
  "lrn": "13364086644"
}

Standard LRN Lookup

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00"
}

Standard LRN Lookup (when activation date unavailable)

{
  "lrn": "13364086644",
  "phone_number": "13364086644"
}

Enhanced LRN Lookup

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "enhanced_lrn": {
    "carrier": "Verizon Wireless",
    "carrier_type": "WIRELESS",
    "city": "Clemmons",
    "state": "NC",
    "zip_code": "27012",
    "county": "Forsyth",
    "country_code": "US",
    "timezone": "-0500",
    "rate_center": "WINSTN SAL",
    "lata": "424",
    "ocn": "6324"
  }
}

LRN with Messaging

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "messaging": {
    "provider": "Verizon Wireless",
    "enabled": true,
    "country": "US",
    "country_code": "1",
    "reference_id": "MSG-xyz"
  }
}

LRN with CNAM

When include_cnam=true, the response includes caller ID name information:

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "cnam": "VERIZON WIRELESS"
}

LRN with Trust Data

When include_trust=true, the response includes trust/reputation information:

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "trust": {
    "is_spam": false,
    "is_robocall": false,
    "is_scam": false,
    "spam_type": "NONE",
    "reputation_score": 85,
    "trust_level": "high",
    "last_updated": "2026-01-18T15:30:00Z"
  }
}

Full Response (All Options Enabled)

When all include options are enabled:

{
  "lrn": "13364086644",
  "phone_number": "13364086644",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "enhanced_lrn": {
    "carrier": "Verizon Wireless",
    "carrier_type": "WIRELESS",
    "city": "Clemmons",
    "state": "NC",
    "zip_code": "27012",
    "county": "Forsyth",
    "timezone": "-0500"
  },
  "messaging": {
    "provider": "Verizon Wireless",
    "enabled": true,
    "country": "US"
  },
  "cnam": "VERIZON WIRELESS",
  "trust": {
    "is_spam": false,
    "is_robocall": false,
    "is_scam": false,
    "spam_type": "NONE",
    "reputation_score": 85,
    "trust_level": "high",
    "last_updated": "2026-01-18T15:30:00Z"
  }
}

Trust Level Values

The trust_level field is derived from the reputation_score:

high: reputation_score >= 70 (trusted number)
medium: reputation_score 40-69 (some concerns)
low: reputation_score < 40 (likely spam/scam)

Product prices · public rates

Each selected product adds its per-number cost. Estimates do not submit lookups or charge your wallet.

lrn: $0.000500 per number
enhanced_lrn: $0.000000 per number
messaging_provider: $0.000900 per number
cnam: $0.006000 per number
spam: $0.007000 per number

Pricing & inclusions