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.

FieldTypeRequiredDescription
phonestringyesThe number to check, international ("+91 98765 43210") or national with country_hint.
country_hintstringnoISO 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 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: "verify_phone"
Over RESTPOST https://api.parel.si/v1/run with "tool": "verify_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":"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

This page as Markdown: /docs/tools/verify_phone.md. Something wrong or missing: hello@parel.si.