> ## 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 类别端点

> `categories` 端点提供特定国家当前 VAT 税率和税类的全面访问，包括符合资格商品和服务的优惠税率。

## 快速开始

### 基础 URL

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

### 类别端点

`categories` 端点需要您的唯一 API 密钥和要检查的国家：

```
https://vat.cleariflow.com/v1/categories/
? api_key = YOUR_UNIQUE_API_KEY
& country_code = DE
```

此成功请求返回全面的 VAT 税率信息，包括标准税率及其关联类别的优惠税率：

<ResponseExample>
  ```json theme={"system"}
  [
      {
          "category": "some agricultural inputs",
          "country_code": "DE",
          "description": "Reduced VAT rate (some agricultural inputs)",
          "rate": "0.070"
      },
      {
          "category": "taxation of some gold coins and jewellery",
          "country_code": "DE",
          "description": "Reduced VAT rate (taxation of some gold coins and jewellery)",
          "rate": "0.070"
      },
      {
          "category": "cut flowers and plants for decorative use and food production",
          "country_code": "DE",
          "description": "Reduced VAT rate (cut flowers and plants for decorative use and food production)",
          "rate": "0.070"
      },
      {
          "category": "e-books",
          "country_code": "DE",
          "description": "Reduced VAT rate (e-books)",
          "rate": "0.070"
      },

      ..................

      {
          "category": "standard",
          "country_code": "DE",
          "description": "Standard VAT rate",
          "rate": "0.190"
      },
      {
          "category": "newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising)",
          "country_code": "DE",
          "description": "Reduced VAT rate (newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising))",
          "rate": "0.070"
      },
      {
          "category": "some timber for industrial use",
          "country_code": "DE",
          "description": "Reduced VAT rate (some timber for industrial use)",
          "rate": "0.070"
      }
  ]
  ```
</ResponseExample>

### 请求参数

<ParamField query="api_key" type="String" required>
  您的唯一 API 密钥。请注意，每个用户为每个 Cleariflow API 拥有独立的 API 密钥，因此您的 VAT 验证 API 密钥无法用于 IP 地理定位 API，例如。
</ParamField>

<ParamField query="country_code" type="String" required>
  您要检索 VAT 类别的国家的两字母 ISO 3166-1 alpha-2 代码。
</ParamField>

### 响应参数

API 响应以通用、轻量的 [JSON 格式](https://www.json.org/json-en.html) 返回。

响应是类别对象数组，每个对象包含：

<ResponseField name="country_code" type="String">
  返回类别所在国家的两字母 ISO 3166-1 alpha-2 代码。
</ResponseField>

<ResponseField name="rate" type="String">
  此类别的 VAT 税率，以小数字符串表示（例如 "0.190" 表示 19%）。
</ResponseField>

<ResponseField name="category" type="String">
  类别名称（例如 "standard"、"e-books"、"audiobooks"）。
</ResponseField>

<ResponseField name="description" type="String">
  关于类别及其适用性的描述。
</ResponseField>