Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-13261150.7 KB
LRN

LRN Lookup (POST)

Retrieve Local Routing Number information for a phone number.

Optional parameters allow including CNAM and Trust data in a single request:

  • include_cnam: Add caller name lookup
  • include_trust: Add reputation scoring with trust_level (high/medium/low)
  • lrn_only: Minimal response with only LRN data (overrides other includes)

Each included lookup is billed separately.

post/api/v1/lrn

Request body

phone_numberstring required
lrn_onlyboolean

Return only LRN data (overrides all other includes)

include_cnamboolean

Include CNAM caller name data

include_trustboolean

Include trust/reputation data with reputation_score (0-100) and trust_level (high/medium/low)

include_enhanced_lrnboolean

Include enhanced carrier and location data

messaging_lookupboolean

Include messaging provider information

Example request

{
  "phone_number": "15555550123"
}

Response

Successful LRN lookup

phone_numberstring
lrnstring
lrn_activated_atstring date-time nullable
carrierstring
line_type'mobile' | 'landline' | 'voip' | 'unknown'

Example response

{
  "phone_number": "15555550123",
  "lrn": "15555550123",
  "lrn_activated_at": "2021-09-01T00:00:00+00:00",
  "carrier": "Verizon Wireless",
  "line_type": "mobile",
  "cnam": {
    "caller_name": "ACME CORP"
  },
  "trust": {
    "spam_type": "NONE",
    "reputation_score": 85,
    "trust_level": "high",
    "last_updated": "2026-01-18T12:30:00Z"
  }
}