Your first number lookup

Prepare your request

You need your main SIP account API key and a telephone number to look up. Save the key locally as A1ROUTES_API_KEY and the number as TELEPHONE_NO.

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"

Inspect the result

Check the HTTP status and content type before parsing the body.

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.

Next steps

Read the LRN endpoint reference, authentication guide, and error handling guidance.