# Phone Number Validation

## Check phone number

<mark style="color:blue;">`GET`</mark> <https://lookup.proweblook.com>

To check whether a number is valid or not

#### Request Body

| Name                                            | Type   | Description                                                      |
| ----------------------------------------------- | ------ | ---------------------------------------------------------------- |
| phone\_number<mark style="color:red;">\*</mark> | string | phonenumber with countrycode which you want to check             |
| api\_key<mark style="color:red;">\*</mark>      | string | Your Proweblook api key                                          |
| country\_code                                   | string | Not required (only if you mention country code in phone\_number) |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{"status":"VALID_CONFIRMED","formatted_number":"+91 90386 55955","linetype":"Mobile","carrier":"Tata Docomo","location":"India","countrycodenum":91,"countrycode":"IN","countryname":"India","formatnational":"090386 55955","formatinternational":"+91 90386 55955","timezone":["Asia\/Calcutta"],"ratelimit_remain":100,"ratelimit_seconds":100}
```

{% endtab %}
{% endtabs %}

### Note

#### Phone Number Validation API Documentation Note

**Overview**

The Phone Validation API provided by ProWebLook allows users to validate phone numbers for various purposes such as ensuring accuracy before utilizing them in applications or verifying user-provided contact information. This document provides guidance on utilizing the API effectively.

**Endpoint**

The endpoint for accessing the Phone Validation API is:

<pre class="language-bash"><code class="lang-bash"><strong>GET https://lookup.proweblook.com/api/v1/phonevalidation
</strong></code></pre>

**Parameters**

* `phone_number`: The phone number to be validated. It should be provided in E.164 format, including the country code, if you dont pass countrycode in phone\_number then you have to use country\_code parameter.
* `country_code`: (Optional) The ISO 3166-1 alpha-2 country code. This parameter helps improve the accuracy of validation by specifying the country of the provided phone number.
* `api_key`: The API key provided by ProWebLook for authentication and authorization purposes.

**Usage**

When making requests to the Phone Validation API, ensure the following:

* Include the `phone_number` parameter with the phone number in E.164 format.
* If known, include the `country_code` parameter to specify the country of the phone number.
* Provide the `api_key` parameter for authentication.

**Example**

```bash
GET https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=919038655955&country_code=IN&api_key=YOUR_API_KEY
```

**Response**

The API response provides information about the validity of the provided phone number along with additional details such as the carrier information, location, and whether it is a mobile or landline number.

**Note**

It is recommended to always include the `country_code` parameter to ensure accurate validation results, especially when dealing with international phone numbers.<br>

If you still need help . please raise a ticket in proweblook.com or email us : <info@proweblook.com>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://proweblook.gitbook.io/proweblook-help-desk/api-docs/phone-number-validation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.