Docs › Network and contact checks
Phone numbers API
Check and format an Indian phone number, and see whose series it is.
Validates an Indian number, tells mobile from toll-free and fixed lines, formats it (E.164 and national), and names the operator and telecom circle a mobile number's series was first given to. With number portability the current operator can differ. Numbers are never written to the request log.
Check a phone number
GET/v1/phone/{number}
What you send here is never written to the log, and the answer is not cached.
| Parameter | Description |
|---|---|
numberpath, required | The number, with or without +91, 91 or 0; spaces and dashes are ignored. |
curl
curl "https://api.dharun.dev/v1/phone/+91%2095001%2012345"JavaScript
const response = await fetch("https://api.dharun.dev/v1/phone/+91%2095001%2012345");
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
console.log(body.data);Python
import requests
response = requests.get("https://api.dharun.dev/v1/phone/+91%2095001%2012345", timeout=10)
body = response.json()
if not response.ok:
raise RuntimeError(body["error"]["message"])
print(body["data"])Response, with lists and long text shortened
{
"data": {
"valid": true,
"type": "mobile",
"e164": "+919500112345",
"national": "95001 12345",
"series": "9500",
"originalOperator": {
"code": "AT",
"name": "Airtel India"
},
"circle": {
"code": "TN",
"name": "Tamil Nadu",
"category": "A",
"area": "State of Tamil Nadu, Puducherry district and Karaikal district"
}
},
"meta": {
"source": {
"name": "Mobile telephone numbering in India",
"url": "https://en.wikipedia.org/w/index.php?title=Mobile_telephone_numbering_in_India&oldid=1376522760",
"licence": "CC BY-SA 4.0",
"version": "revision 1376522760",
"retrieved": "2026-10-13",
"attribution": "Mobile number series adapted from the Wikipedia article \"Mobile telephone numbering in India\", licensed CC BY-SA 4.0. This dataset is shared under the same lice…"
},
"note": "Checks the number's form and names who its series was first given to. With number portability the current operator can differ, and whether the number is in use …"
}
}Data source
Mobile telephone numbering in India, revision 1376522760. Retrieved 2026-10-13. Licence: CC BY-SA 4.0. Mobile number series adapted from the Wikipedia article "Mobile telephone numbering in India", licensed CC BY-SA 4.0. This dataset is shared under the same licence.
Using an AI assistant? Connect the MCP server and it can call this API by itself.