> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/validate-phone/individual-lookup.md).

# Individual Lookup

Check one phone number with your own Phone Validator key. Synchronous, returns the result directly.

<mark style="color:green;">`POST`</mark> `/validate_phone`

{% hint style="info" %}
**Free in Parvenu credits.** It uses your own Phone Validator key, saved on the [Integrations](https://app.parvenu.io/app/integrations) page, so Phone Validator bills your account for each number. Returns the result directly in the response, no list and no polling.
{% endhint %}

Pass a phone number in any format. For numbers outside the US and Canada, include `+` and the country code.

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name           | Type   | Description                                                                                         |
| -------------- | ------ | --------------------------------------------------------------------------------------------------- |
| `api_key`      | string | Your API Key.                                                                                       |
| `phone_number` | string | The phone number to check, any format. Outside the US and Canada, include `+` and the country code. |

**Response**

The record is under `data`. See [Response Format](https://developer.parvenu.io/getting-started/response-format.md) for the fields every endpoint returns.

| Field            | Type   | Description                                                                    |
| ---------------- | ------ | ------------------------------------------------------------------------------ |
| `phone_number`   | string | The number that was checked, echoed back.                                      |
| `phone_type`     | string | `Cell Phone`, `Landline`, `VOIP`, `Toll-Free`, `Unknown`, `Fake` or `Invalid`. |
| `phone_company`  | string | The phone company, for example `T-MOBILE`.                                     |
| `fake_number`    | string | `Yes` or `No`.                                                                 |
| `phone_location` | string | Where the number was issued, from its area code. Not where the phone is now.   |

When Phone Validator cannot be reached, only `phone_number` comes back and `message` starts with `Not checked`.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "phone_number": "7029270000"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "phone_number": "7029270000",
    "phone_type": "Cell Phone",
    "phone_company": "T-MOBILE",
    "fake_number": "No",
    "phone_location": "LAS VEGAS, NV"
  },
  "credits_used": 0.0,
  "credits_remaining": 4823.0,
  "message": "Cell Phone, T-MOBILE. Free in Parvenu credits.",
  "success": true
}
```

{% endtab %}

{% tab title="Error: no key saved" %}

```json
{
  "status": "error",
  "error": {
    "code": "http_error",
    "message": "No Phone Validator key found. Add your key on the Integrations page, then try again.",
    "detail": "no_phone_validator_key"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}

With no Phone Validator key saved, the call answers `400` before anything is looked up, and nothing is charged. If Phone Validator refuses your key, your account is inactive or it is out of funds, the call answers `400` with `detail` set to `phone_validator_key_rejected`, `phone_validator_account_inactive` or `phone_validator_out_of_funds`.

To check every contact in a list in one call instead, use [List Lookup](https://developer.parvenu.io/enrichments/validate-phone/list-lookup.md).
