> ## 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-ключі для кожного 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>