HLR Check

POST

/api/v1/recharge/hlr-check

HLR Check API
Perform real-time Home Location Register (HLR) lookup to identify the telecom operator and service circle associated with a mobile number. This API enables automatic operator detection, reduces recharge failures caused by incorrect operator selection, and improves transaction success rates. Commonly used for number validation, smart recharge flows, and fraud prevention before initiating a recharge request.

Request

Header Params

Body Params application/json

Example

{
    "mobile_number": 9999999999,
    "type": "mobile"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/recharge/hlr-check' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mobile_number": 9999999999,
    "type": "mobile"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "response_code": 200,
    "status": "success",
    "message": "Success",
    "data": {
        "operator": "Airtel",
        "circle": "Bihar Jharkhand"
    },
    "meta": {
        "request_id": "902e2cd0-4b84-46f8-9dbb-fc6b84906333",
        "time": "2026-02-22T16:10:24+05:30"
    }
}

🟠401Unauthorized

🟠422Validation Error

Operator List

DTH Info