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 does the live check with carrier and activity, find_phone 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
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:
{
"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
This page as Markdown: /docs/tools/validate_phone.md. Something wrong or missing: hello@parel.si.