Look up a number | A1ROUTES Developers

Retrieve LRN information for a telephone number using your main SIP account API key.

Request

Retrieve LRN information for a telephone number using your main SIP account API key.

GET/lookup/lrnLookup API

Parameters

Parameter	Type	Required	Description
`tn`	string	Yes	Telephone number to look up. Use the number format enabled for your account.
`extended`	boolean	No	Request extended lookup information. The example uses true.

Examples

Request example

1curl --fail-with-body --get \
2  "https://control.a1routes.com/api/lookup/lrn" \
3  --data-urlencode "api_key=$A1ROUTES_API_KEY" \
4  --data-urlencode "extended=true" \
5  --data-urlencode "tn=$TELEPHONE_NO"

Response

Sample JSON output for an extended LRN lookup (extended=true):

{
  "CITY": "RAMSEY",
  "code": 200,
  "LINETYPE": "WIRELESS",
  "DNC": "",
  "OCN": "4036",
  "COUNTRY": "",
  "LOOKUP_TYPE": "EXTENDED",
  "JURISDICTION": "INDETERMINATE",
  "NUMBER": "12014667482",
  "LRN": "12014667482",
  "STATE": "NJ",
  "LEC": "NEW CINGULAR WIRELESS PCS, LLC - DC",
  "LATA": "224",
  "SPID": "",
  "msg": "Operation successful",
  "type": "+OK"
}

This example shows a successful lookup. Values vary by telephone number. Keep telephone numbers and identifiers as strings, and preserve field-name capitalization. Some fields can be empty strings, as shown for DNC, COUNTRY, and SPID; do not interpret an empty value as a negative result. The code field is part of the JSON body; check the HTTP status separately.

Integration notes

Use your main SIP account key, not an A1PBX key. extended=true requests additional data; do not assume every number has every field. Confirm number-format requirements, usage charges, and request limits with support.

See authentication, pagination, and error handling.