> ## 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 密钥。请注意，每个用户为每个 Cleariflow API 拥有独立的 API 密钥，因此您的 VAT 验证与税率 API 密钥无法用于 IP 地理定位 API，例如。
</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">
  若提交的 VAT 号码有效则为 true。
</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">
  与 VAT 号码关联国家的两字母 ISO 3166-1 alpha-2 代码。
</ResponseField>

<ResponseField name="country.name" type="String">
  与 VAT 号码关联国家的名称。
</ResponseField>