# 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.

Base URL `https://api.dharun.dev`. No API key. Answers are JSON, `{ "data": ..., "meta": { ... } }`, and errors are `{ "error": { "code", "message" } }` with a matching HTTP status. Rate limit: 600 requests a minute per client.

## Check a phone number

`GET /v1/phone/{number}`

What you send is never written to the log, and the answer is not cached.

Parameters:

- `number` (path, required): The number, with or without +91, 91 or 0; spaces and dashes are ignored.

Example: https://api.dharun.dev/v1/phone/+91%2095001%2012345

Response, with lists and long text shortened:

```json
{
  "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](https://en.wikipedia.org/w/index.php?title=Mobile_telephone_numbering_in_India&oldid=1376522760), 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.