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

# 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`](https://parel.si/docs/tools/find_phone.md) finds a known person's number; [`verify_email`](https://parel.si/docs/tools/verify_email.md) 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

```bash
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):

```json
{
  "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_phone`](https://parel.si/docs/tools/find_phone.md) to find a known person's number.
- [`verify_email`](https://parel.si/docs/tools/verify_email.md) for the same check on an address.
