Check number reachability

GET

/v1/hlr/{number}

HLR Lookup

Last modified:2026-10-08 14:02:16

Perform a Live-Status HLR lookup.

Authentication — choose one:

API key: send X-API-Key: YOUR_API_KEY.

Bearer token: send Authorization: Bearer YOUR_ACCESS_TOKEN. Obtain the token from POST /v1/auth/token.

Use one method per request, not both. If both are supplied, the API key takes precedence.

Request

Authorization

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

cURLHttpiewget

curl --location 'https://verify.veloconnect.me/v1/hlr/447700900000?reference=&include_raw='

Response Example

200 - Success Example

{
    "msisdn": "447700900000",
    "countryCode": "44",
    "numberType": "MOBILE",
    "numberValid": true,
    "numberStatus": "LIVE",
    "networkName": "Example Mobile UK",
    "reasonCode": "OK",
    "queryType": "liveStatus",
    "serviceUsed": "hlr"
}

Modified at 2026-10-08 14:02:16

Refresh an access token

Look up the current network