HLR Lookup Documentation

The HLR Lookup Developer Hub

Welcome to the HLR Lookup help pages. Here you'll find all the information you need to get started with our API or batch upload services.
Search the docs for explanations on the results you'll receive and a breakdown of all the possible parameters available.

Balance Requests over API

Here's how to obtain your current balance using the API

The process of getting your balance using the API is the same as HLR Lookup request, the required parameters are the same but the base URL has slightly changed by adding /balance at the end.

This is a free request.

URL: https://hlrlookup.com/api/balance/
Method: GET

Required Parameters

apikey - Your API key, obtained from account settings

password - Your account password




Replace $key and $password with your own details


function balance_check($key,$password)
    $curl = curl_init("https://www.hlrlookup.com/api/balance/?apikey=$key&password=$password");
    curl_setopt($curl, CURLOPT_HEADER,0);
    curl_setopt($curl, CURLOPT_POST, 0);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    return $response;
static size_t balance_result(char *ptr, size_t size, size_t nmemb, void *userdata)
	printf( "Balance Result: %s\n" ptr );
	return size*nmemb;
CURLcode balance_check( char* szKey, char* szPassword )
	char szURL[1024];
	sprintf( szURL, "https://www.hlrlookup.com/api/balance/?apikey=%s&password=%s", szKey, szPassword );
	CURL* pCurl = curl_easy_init();
	curl_easy_setopt( pCurl, CURLOPT_URL, szURL );
	curl_easy_setopt( pCurl, CURLOPT_FOLLOWLOCATION, 1L );
	curl_easy_setopt( pCurl, CURLOPT_WRITEFUNCTION, &balance_result );
	curl_easy_setopt( pCurl, CURLOPT_HEADER, 0 );
	curl_easy_setopt( pCurl, CURLOPT_POST, 0L );
	CURLcode res = curl_easy_perform( pCurl );
	return res;
void hlr_check( string key, string password )
	WebRequest webRequest = WebRequest.Create("https://www.hlrlookup.com/api/balance/?apikey="+key+"&password="+password);
	webRequest.Method = "GET";
	WebResponse webResp = webRequest.GetResponse();

Balance Requests over API

Here's how to obtain your current balance using the API

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.