The Extended LRN Data API allows you to look up Local Routing Number (LRN/LNP) information in an extended format with the addition of providing Line Provider and Line Type Details.
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
Please note there could be an additional cost for running this type of lookup. Please check with your account manager for pricing details.
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/extended-lrn/{tn}
curl -v -X GET \ -H "X-Auth-Token: {AUTH_TOKEN}" \
http://{SERVER}:{PORT}/v2/accounts/{ACCOUNT_ID}/lookup/extended-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() | |
| line_type | Line Type Details | string() | landline mobile |
In addition to the keys listed above you will also find the line_provider details
- id – Line Provider’s Carrier ID if provided (not Required)
- name – The Line Provider’s Name
- mms_email – If a mobile number, we will also provide the mms email address
- sms_email – If a mobile number, we will also provide the sms email address
Below is an example of data provided for a SMS/Mobile enabled Number:
"data": {
"tn": "5708323341",
"lrn": "",
"ported_status": "N",
"ocn": "6392",
"line_type": "1",
"spid": "6006",
"spid_carrier_name": "CELLCO PARTNERSHIP DBA VERIZON WIRELESS - PA",
"spid_carrier_type": "",
"altspid": "",
"altspid_carrier_name": "",
"altspid_carrier_type": "",
"city": "MILFORD",
"state": "Pennsylvania",
"line_provider": {
"id": "6006",
"mms_email": "5708323341@vzwpix.com",
"name": "Verizon Wireless",
"sms_email": "5708323341@vtext.com"
},
"linetype": "mobile"