v1

latestOpenAPI 3.0.3Proprietary2026-07-13261150.7 KB
LRN

LRN Lookup (GET)

Retrieve Local Routing Number information for a phone number

get/api/v1/lrn

Query parameters

phone_numberstring required
Example:15555550123

Phone number in E.164 or national format

lrn_onlyboolean

Return only LRN data (disables all other includes for minimal, fast response)

include_enhanced_lrnboolean

Include enhanced carrier and location data (city, state, timezone)

messaging_lookupboolean

Include messaging provider information

include_cnamboolean

Include CNAM (caller name) data in response

include_trustboolean

Include trust/reputation data with reputation_score and trust_level

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"
  }
}