NNumberVerifyHub
Sign in Get started
Home / API

Developer API

Automate SMS verification with a small, predictable REST API. Two calls cover the core flow: allocate a number, then poll for its code. Keys, per-app quotas and analytics are built in.

Quick start

Two calls, start to code

Authenticate with your API key, allocate a number for a service and country, then poll /get_code until the SMS arrives. Responses are plain JSON.

Get an API key
# Authenticate with a header on every call X-API-Key: nk_live_xxxxxxxxxxxxxxxxxxxx # 1 — allocate a number POST https://api.numberverifyhub.com/get_number { "application": "telegram", "country_code": "44" } → { "status": true, "data": { "full_number": "+447822014593", "mdr_id": 89864364622 } } # 2 — poll for the code (long-polls up to ~30s) POST https://api.numberverifyhub.com/get_code { "application": "telegram", "full_number": "+447822014593", "mdr_id": 89864364622 } → { "status": true, "data": { "code": "84921" } }
Endpoints

The core surface

POST
/get_number
Allocate a fresh number for a service and country. Returns the number and an mdr_id to reference the reservation.
POST
/get_code
Poll for the verification SMS on an allocated number. Long-polls briefly and returns the extracted code once it arrives.
POST
/update_mdr_id
Continue the same number for a follow-up code — clone the session under a new reservation id.
POST
/get_applications
List the services your key is allowed to use, with per-application rate limits.
POST
/get_countries
List the countries available for a given service under your key's grant.

Rate limits, per-app quotas and usage analytics apply per key and are visible in your dashboard.

🔑

API keys

Issue and rotate keys from your dashboard, each scoped to the services it may use.

📊

Usage analytics

Per-app counts of numbers used, codes requested and codes received, over any window.

🚦

Predictable limits

Per-minute and per-hour rate limits per key and per app, reported so you can pace yourself.

Build verification into your app

Create an account, generate a key, and make your first call in minutes.

Get an API key Check API status