> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validate VAT endpoint

> The `validate` endpoint processes VAT number submissions to verify authenticity and retrieve comprehensive business information including company details, address, and country registration data.

## Getting started

### Base URL

```
https://vat.cleariflow.com/v1/validate/
```

### Validation endpoint

The `validate` endpoint requires your unique API key and the VAT number you'd like to check:

```
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
```

This successful request returns comprehensive company information associated with the validated VAT number:

<ResponseExample>
  ```json theme={"system"}
  {
      "company": {
          "address": "8 RUE DE LONDRES\n75009 PARIS",
          "name": "EURL GOOGLE FRANCE"
      },
      "country": {
          "code": "FR",
          "name": "France"
      },
      "valid": true,
      "vat_number": "FR64443061841"
  }
  ```
</ResponseExample>

### Request parameters

<ParamField query="api_key" type="String" required>
  Your unique API key. Note that each user has unique API keys for each of Cleariflow APIs, so your VAT Validation and Rates API key will not work for your IP Geolocation API, for example.
</ParamField>

<ParamField query="vat_number" type="String" required>
  The VAT number to validate.
</ParamField>

### Response parameters

The API response is returned in a universal and lightweight [JSON format](https://www.json.org/json-en.html).

<ResponseField name="vat_number" type="String">
  The VAT number to validate.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  Is true if the submitted VAT number is valid.
</ResponseField>

<ResponseField name="company" type="Object">
  Object containing company information.
</ResponseField>

<ResponseField name="company.name" type="String">
  The name of the company associated with the VAT number.
</ResponseField>

<ResponseField name="company.address" type="String">
  The address of the company associated with the VAT number.
</ResponseField>

<ResponseField name="country" type="Object">
  Object containing country information.
</ResponseField>

<ResponseField name="country.code" type="String">
  The two letter ISO 3166-1 alpha-2 code of the country associated with the VAT number.
</ResponseField>

<ResponseField name="country.name" type="String">
  The name of the country associated with the VAT number.
</ResponseField>