API keys

Keys are not issued yet

A live key looks like sv2_live_, an 8 character prefix, and a 32 character secret. We show it once. The database keeps the prefix and an HMAC-SHA256 hash, never the secret. Several keys can exist per account, each with a name, scopes, and an optional IP allowlist.

API access

Not live

Lookup endpoint

Endpoint URL

https://api.sv2labs.com/v1/lrn/lookup

Example request

curl -sS -X GET "https://api.sv2labs.com/v1/lrn/lookup?tn=+13234473116" \
  -H "Authorization: Bearer sv2_live_demo0001_••••••••••••••••••••••••••••••••"

Example only. A real key is shown once, stored as a hash, and never put in this page.

Example response

{
  "number": "+13234473116",
  "lrn": "6267570000",
  "is_ported": true,
  "carrier_name": "Example Carrier",
  "line_type": "C",
  "state": "CA",
  "lata": "730",
  "ocn": "6529"
}