LRN

he LRN Data API allows you to look up Local Routing Number (LRN/LNP) information in an extended format.

The LRN Data API can be used in:

• Routing (perform a dip to retrieve the LRN and based on whether the number has been ported route the call to its ultimate destination)
• Billing (validating that the calls in the past were billed and or routed correctly by checking LRNs for the telephone number against the LRNs in the CDRs)
• Billing (inter/intra regions or carriers are sometimes billed differently than normal calls based on your agreements)
• Modeling legitimate calls in order to detect fraud

Parameters

Key	Description	Type	Required
account_id	The account id used to generate your auth-token	string()	yes
tn	10-digit phone number	string()	yes

GET /v2/accounts/{account_id}/lookup/lrn/{tn}

curl -v -X GET \ -H "X-Auth-Token: {AUTH_TOKEN}" \ 
http://{SERVER}:{PORT}/v2/accounts/{ACCOUNT_ID}/lookup/lrn/{TN} 

Response Schema

Key	Description	Type	Default Data
tn	provided tn Parameter	string()
lrn	Local Routing Number	string()
port_status	If the numbers has been ported	string()	Y = Yes, N = No
ocn	Operating Carrier Number	string()
line_type	Provides the type of service line associated with the tn	string()	0 -> Wireline , 1 -> Wireless , 2 -> VOIP
spid	The four-digit identifier of SP	String()
spid_carrier_name	Name of the Service Provider	string()
spid_carrier_type	Type of Service Provider	string()
altspid	The four-digit identifier of a second service provider associated	string()
altspid_carrier_name		string()
altspid_carrier_type		string()
city	City TN is located in	string()
State	State TN is located in	string()

Here is an example of the data pulls on a standard LRN lookup

data": {
        "tn": "4103963835",
        "lrn": "",
        "ported_status": "N",
        "ocn": "9212",
        "line_type": "0",
        "spid": "9211",
        "spid_carrier_name": "VERIZON MARYLAND, INC.",
        "spid_carrier_type": "",
        "altspid": "",
        "altspid_carrier_name": "",
        "altspid_carrier_type": "",
        "city": "BALTIMORE",
        "state": "Maryland"
    }