> ## 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番号に関連する国の2文字ISO 3166-1 alpha-2コードです。
</ResponseField>

<ResponseField name="country.name" type="String">
  VAT番号に関連する国の名前です。
</ResponseField>