> ## 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-Kategorien-Endpunkt

> Der `categories`-Endpunkt liefert umfassenden Zugriff auf aktuelle VAT-Sätze und Steuerkategorien für bestimmte Länder, einschließlich ermäßigter Sätze für qualifizierende Waren und Dienstleistungen.

## Erste Schritte

### Basis-URL

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

### Kategorien-Endpunkt

Der `categories`-Endpunkt benötigt Ihren eindeutigen API-Schlüssel und das gewünschte Land:

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

Diese erfolgreiche Anfrage liefert umfassende VAT-Satzinformationen einschließlich Standardsätzen und ermäßigten Sätzen mit zugehörigen Kategorien:

<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>

### Anfrageparameter

<ParamField query="api_key" type="String" required>
  Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr VAT-Validierungs-API-Schlüssel funktioniert z. B. nicht für die IP-Geolokalisierungs-API.
</ParamField>

<ParamField query="country_code" type="String" required>
  Der zweistellige ISO-3166-1-alpha-2-Code des Landes, für das VAT-Kategorien abgerufen werden sollen.
</ParamField>

### Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen [JSON-Format](https://www.json.org/json-en.html) zurückgegeben.

Die Antwort ist ein Array von Kategorieobjekten, wobei jedes Objekt Folgendes enthält:

<ResponseField name="country_code" type="String">
  Der zweistellige ISO-3166-1-alpha-2-Code des Landes, für das die Kategorien zurückgegeben werden.
</ResponseField>

<ResponseField name="rate" type="String">
  Der VAT-Satz für diese Kategorie als Dezimalzeichenkette (z. B. „0.190" für 19 %).
</ResponseField>

<ResponseField name="category" type="String">
  Der Name der Kategorie (z. B. „standard", „e-books", „audiobooks").
</ResponseField>

<ResponseField name="description" type="String">
  Eine Beschreibung der Kategorie und ihrer Anwendbarkeit.
</ResponseField>