RESTful API

Powerful Phone Validation API

Simple, fast, and reliable phone number validation with comprehensive documentation and code examples.

Real-time HLR lookup

Bulk validation up to 1,000 numbers

Detailed carrier information

Global coverage (200+ countries)

Get API Key View Pricing

Quick Start

Get started in minutes

Create Account

Generate API Key

Create an API key in your dashboard

Make First Request

Start validating phone numbers

Authentication

Include your API key in the X-API-Key header with every request:

X-API-Key: your_api_key_here

Keep your API key secret. Never expose it in client-side code.

Base URL: https://hlrdeep.com/api/public/v1

https://hlrdeep.com/api/public/v1

Available Endpoints

Single Number Validation

Validate a single phone number and get carrier information, live status, and porting details.

Query Parameters

phoneNumberstring required

Phone number in international format (e.g., +1234567890)

Code Examples

curl -X GET "https://hlrdeep.com/api/public/v1/hlr/check?phoneNumber=%2B1234567890" \
  -H "X-API-Key: your_api_key_here"

Response

{
  "success": true,
  "data": {
    "phoneNumber": "+1234567890",
    "isValid": true,
    "country": "United States",
    "countryCode": "US",
    "operator": "Verizon Wireless",
    "operatorCode": "310-004",
    "type": "Mobile",
    "status": "Active",
    "ported": false,
    "roaming": false,
    "mcc": "310",
    "mnc": "004"
  },
  "balance": 95.50
}

Error Codes

Common HTTP status codes and their meanings:

Code	Message
`200`	Success
`400`	Bad Request - Invalid phone number format
`401`	Unauthorized - Invalid API key
`402`	Payment Required - Insufficient balance
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error

Sandbox Environment

Test your integration without charges by creating a sandbox API key. Sandbox keys return realistic test data.

No charges to your balance
Realistic test responses
Perfect for development

Create Sandbox Key

Ready to integrate?

Create your free account and get your API key in under 5 minutes

Free sandbox testing

Comprehensive documentation

Code examples in 4 languages

Get API Key View Pricing