verify_phone
Whether a phone number is valid, with its country, carrier, line type, prepaid flag and activity score. ₹1.70 per check, valid or not.
What it does
Send the phone in international format ("+91 98765 43210"), or in national format with country_hint ("IN"), and get data with phone_number in international format, is_valid, country_code and country_name, carrier, line_type (mobile, landline, VoIP), is_prepaid and activity_score (how recently the number has been in use), from the numbering plan and carrier records.
Use it before calling or messaging a number you were given or found, to drop dead and mistyped numbers. It never says who owns the number: there is no reverse lookup here. find_phone finds a known person's number; verify_email does the same job for an address. Numbers are checked one at a time and the answer is never stored by Parel.
India: Indian mobile and landline numbers are covered; the live check's +91 number came back with its carrier and line type.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
phone | string | yes | The number to check, international ("+91 98765 43210") or national with country_hint. |
country_hint | string | no | ISO country code ("IN") when the number is in national format. |
What drives the cost
Nothing you can turn: priced per check whatever the verdict. The source bills every answer, an invalid number and a number it cannot match included, so a wrong number still costs a check; only a source failure is ₹0. Under a second.
Price today
| Price today | ₹1.70 per check (cost_paise: 170) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.55 (hold_paise: 255); 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: "verify_phone" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "verify_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":"verify_phone","input":{"phone":"+91 98765 43210"}}'
What comes back
data. A real answer recorded during the live check of 2026-11-05 (an Indian mobile number of the kind used in examples, in 0.7 s):
{
"id": "Phone.d88fcc3c-3e66-45bd-86ef-620505d66141",
"phone_number": "+919876543210",
"is_valid": true,
"activity_score": 80,
"country_calling_code": "91",
"country_code": "IN",
"country_name": "India",
"line_type": "Mobile",
"carrier": "AirTelecom LtdLtd-Madhya Pradesh",
"is_prepaid": null,
"error": null,
"warnings": []
}
Notes
- Priced per check whatever the verdict: an invalid number is still a check. Only a source failure is free.
- Says whether a number is valid, active and what type; never who owns it.
- Numbers are checked one at a time and never stored by Parel.
Siblings
find_phoneto find a known person's number.verify_emailfor the same check on an address.
This page as Markdown: /docs/tools/verify_phone.md. Something wrong or missing: hello@parel.si.