LRN API - Local Routing Number Lookup

Overview

The LRN (Local Routing Number) API provides fast routing number lookup for phone numbers. Perfect for high-volume applications that need routing information without additional data.

Key Features

Ultra-fast Performance: Optimized for high-volume processing
Routing Information: Get LRN data for call routing
Enhanced Data: Optional carrier and location details
Messaging Integration: Optional messaging provider data
High Availability: 99.9% uptime guarantee

Authentication

All API requests require authentication using your API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Don't have an API key? Get your API key here.

API Methods

REST Endpoint

POST https://api-service.verirouteintel.io/v1/lrn

Request Body

{
  "phone_number": "13364086644",
  "include_enhanced_lrn": true,
  "messaging_lookup": true
}

Response

{
  "lrn": "13364086644",
  "enhanced_lrn_data": {
    "carrier": "Verizon",
    "carrier_type": "WRS",
    "city": "New York",
    "zip_code": "10001",
    "county": "New York",
    "timezone": "-0500",
    "state": "NY",
    "rate_center": "NYC",
    "lata": "132",
    "ocn": "921"
  },
  "messaging": {
    "provider": "Verizon Wireless",
    "enabled": true,
    "country": "US",
    "country_code": "1",
    "reference_id": "MSG-abc123"
  }
}

GraphQL Endpoint

POST

https://api-service.verirouteintel.io/graphql

query LookupLrn($number: String!, $includeEnhanced: Boolean, $includeMessaging: Boolean) {
  lookupLrn(phoneNumber: $number, includeEnhancedLrn: $includeEnhanced, includeMessaging: $includeMessaging) {
    lrn
    enhanced_lrn_data {
      carrier
      carrier_type
      city
      zip_code
      county
      timezone
      state
      rate_center
      lata
      ocn
    }
    messaging {
      provider
      enabled
      country
      country_code
      reference_id
    }
  }
}

Variables

{
  "number": "13364086644",
  "includeEnhanced": true,
  "includeMessaging": true
}

Response

{
  "data": {
    "lookupLrn": {
      "lrn": "13364086644",
      "enhanced_lrn_data": {
        "carrier": "Verizon",
        "carrier_type": "WRS",
        "city": "New York",
        "zip_code": "10001",
        "county": "New York",
        "timezone": "-0500",
        "state": "NY",
        "rate_center": "NYC",
        "lata": "132",
        "ocn": "921"
      },
      "messaging": {
        "provider": "Verizon Wireless",
        "enabled": true,
        "country": "US",
        "country_code": "1",
        "reference_id": "MSG-abc123"
      }
    }
  }
}

Parameters

Parameter	Type	Required	Description
`phone_number` / `phoneNumber`	string	Yes	The phone number to lookup (11-digit US number)
`include_enhanced_lrn` / `includeEnhancedLrn`	boolean	No	Include enhanced LRN data (default: false)
`messaging_lookup` / `includeMessaging`	boolean	No	Include messaging provider data (default: false)

Response Format

Standard LRN Lookup

{
  "lrn": "13364086644"
}

Enhanced LRN Lookup

{
  "lrn": "13364086644",
  "enhanced_lrn_data": {
    "carrier": "Verizon",
    "carrier_type": "WRS",
    "city": "New York",
    "zip_code": "10001",
    "county": "New York",
    "timezone": "-0500",
    "state": "NY",
    "rate_center": "NYC",
    "lata": "132",
    "ocn": "921"
  }
}

LRN with Messaging

{
  "lrn": "13364086644",
  "messaging": {
    "provider": "Verizon Wireless",
    "enabled": true,
    "country": "US",
    "country_code": "1",
    "reference_id": "MSG-abc123"
  }
}

Code Examples

cURL - REST API

curl -X POST https://api-service.verirouteintel.io/v1/lrn \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "13364086644", "include_enhanced_lrn": true, "messaging_lookup": true}'

cURL - GraphQL

curl -X POST https://api-service.verirouteintel.io/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query LookupLrn($number: String!, $includeEnhanced: Boolean, $includeMessaging: Boolean) { lookupLrn(phoneNumber: $number, includeEnhancedLrn: $includeEnhanced, includeMessaging: $includeMessaging) { lrn enhanced_lrn_data { carrier carrier_type city zip_code county timezone state rate_center lata ocn } messaging { provider enabled country country_code reference_id } } }",
    "variables": {"number": "13364086644", "includeEnhanced": true, "includeMessaging": true}
  }'

Python - REST API

import requests

url = "https://api-service.verirouteintel.io/v1/lrn"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_number": "13364086644",
    "include_enhanced_lrn": True,
    "messaging_lookup": True
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)

Python - GraphQL

import requests

url = "https://api-service.verirouteintel.io/graphql"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
query = """
query LookupLrn($number: String!, $includeEnhanced: Boolean, $includeMessaging: Boolean) {
  lookupLrn(phoneNumber: $number, includeEnhancedLrn: $includeEnhanced, includeMessaging: $includeMessaging) {
    lrn
    enhanced_lrn_data {
      carrier
      carrier_type
      city
      zip_code
      county
      timezone
      state
      rate_center
      lata
      ocn
    }
    messaging {
      provider
      enabled
      country
      country_code
      reference_id
    }
  }
}
"""
variables = {"number": "13364086644", "includeEnhanced": True, "includeMessaging": True}

response = requests.post(url, headers=headers, json={
    "query": query,
    "variables": variables
})
result = response.json()
print(result)

Error Handling

The API returns standard HTTP status codes and detailed error messages:

{
  "error": "Invalid phone number format",
  "details": "Phone number must be 11 digits starting with 1"
}

Rate Limits

API requests are limited to:

Free tier: 10 requests per month
Paid plans: Based on your subscription level