> ## 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.

# Ендпоінт перевірки VAT

> Ендпоінт `validate` обробляє номери VAT, перевіряє їхню автентичність і повертає повну інформацію про компанію, включаючи реквізити, адресу та дані реєстрації в країні.

## Початок роботи

### Базовий URL

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

### Ендпоінт перевірки

Ендпоінт `validate` потребує вашого унікального API-ключа та номера VAT, який потрібно перевірити:

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

Цей успішний запит повертає повну інформацію про компанію, пов'язану з перевіреним номером VAT:

<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>

### Параметри запиту

<ParamField query="api_key" type="String" required>
  Ваш унікальний API-ключ. Зверніть увагу: у кожного користувача є унікальні API-ключі для кожного API Cleariflow, тому ключ API перевірки VAT і ставок не працюватиме для API геолокації IP, наприклад.
</ParamField>

<ParamField query="vat_number" type="String" required>
  Номер VAT для перевірки.
</ParamField>

### Параметри відповіді

Відповідь API повертається у універсальному та легкому форматі [JSON](https://www.json.org/json-en.html).

<ResponseField name="vat_number" type="String">
  Номер VAT для перевірки.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  `true`, якщо переданий номер VAT дійсний.
</ResponseField>

<ResponseField name="company" type="Object">
  Об'єкт із інформацією про компанію.
</ResponseField>

<ResponseField name="company.name" type="String">
  Назва компанії, пов'язаної з номером VAT.
</ResponseField>

<ResponseField name="company.address" type="String">
  Адреса компанії, пов'язаної з номером VAT.
</ResponseField>

<ResponseField name="country" type="Object">
  Об'єкт із інформацією про країну.
</ResponseField>

<ResponseField name="country.code" type="String">
  Дволітерний ISO 3166-1 alpha-2 код країни, пов'язаної з номером VAT.
</ResponseField>

<ResponseField name="country.name" type="String">
  Назва країни, пов'язаної з номером VAT.
</ResponseField>