Phone

HLR lookup for a mobile number

Queries the mobile network for live subscriber status, roaming state and current carrier. Costs 5 credits; a number the network reports as invalid costs nothing.

post/hlr-lookup

Request

  • Base URL: https://app.1lookup.io/api/v1
  • URL: https://app.1lookup.io/api/v1/hlr-lookup
  • Auth: HTTP bearer

Request body

phone_numberstring required

Mobile number in E.164 format.

bypass_cacheboolean

Skip the 7-day result cache and run a fresh lookup. Also accepted as bypassCache or forceFresh, in the body or the query string. A cached result you ran yourself is free; a fresh lookup is charged as usual.

Example request

{
  "phone_number": "+447700900123"
}

Response

Lookup completed. metadata.credits_used says what it cost.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.