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.

FieldTypeRequiredDescription
phonestringyesThe number in international digits ("919876543210" or "+91 98765 43210"), or a national number with input_format.
input_formatstringnoISO3 country code when the number is national ("IND").
output_formatstringnoHow 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 todayFree 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "validate_phone"
Over RESTPOST https://api.parel.si/v1/run with "tool": "validate_phone"
Confirmationnot 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.