> ## 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-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ API проверки VAT не будет работать, например, с API геолокации IP.
</ParamField>

<ParamField query="country_code" type="String" required>
  Двухбуквенный ISO 3166-1 alpha-2 код страны, для которой нужно получить категории VAT.
</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>