> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/validate_phone

# validate_phone

> Whether a phone number is well formed and which network issued it, with its type and country. Free; no live check. Free per check; a result that finds nothing is ₹0.

## What it does

A free check of one phone number against the numbering plan: data with the detected number, telephone_number_type (MOBILE, LANDLINE…), the network that issued the number range (original_network_details: name, country) and the number formatted as you ask with output_format. It does not check whether the number is live or in use, and it says nothing about who owns it: [`verify_phone`](https://parel.si/docs/tools/verify_phone.md) does the live check with carrier and activity, [`find_phone`](https://parel.si/docs/tools/find_phone.md) finds a known person's number. Free: there is no charge whatever the verdict. Under two seconds.

India: Indian numbers are covered; the live check named the issuing network and MOBILE for a +91 number.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `phone` | string | yes | The number in international digits ("919876543210" or "+91 98765 43210"), or a national number with input_format. |
| `input_format` | string | no | ISO3 country code when the number is national ("IND"). |
| `output_format` | string | no | How to format the number back: E164, PLUS_E164, NATIONAL or an ISO3 country code. |

## What drives the cost

Free, whatever the verdict. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **Free** per check (`cost_paise: 0`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "validate_phone"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "validate_phone"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"validate_phone","input":{"phone":"+919876543210"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "detected_telephone_number": "919876543210",
  "formatted_telephone_number": "",
  "original_network": "AVAILABLE",
  "original_network_details": {
    "name": "Airtel - Punjab",
    "mccmnc": "40402",
    "country_name": "India",
    "country_iso3": "IND",
    "area": "India",
    "country_prefix": "91"
  },
  "timestamp": "2026-11-05T14:05:46Z",
  "telephone_number_type": "MOBILE"
}
```

## Notes

- Free, whatever the verdict.
- Numbering-plan facts only: the network that issued the range and the type. verify_phone says whether the number is live.
- Never stored by Parel.

## Siblings

- [`verify_phone`](https://parel.si/docs/tools/verify_phone.md)
- [`find_phone`](https://parel.si/docs/tools/find_phone.md)
