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

# Endpoint des catégories TVA

> L'endpoint `categories` donne accès aux taux de TVA actuels et aux catégories fiscales pour des pays spécifiques, y compris les taux réduits pour les biens et services éligibles.

## Premiers pas

### URL de base

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

### Endpoint des catégories

L'endpoint `categories` requiert votre clé API unique et le pays que vous souhaitez consulter :

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

Cette requête réussie renvoie des informations complètes sur les taux de TVA, incluant les taux standard et réduits avec leurs catégories associées :

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

### Paramètres de requête

<ParamField query="api_key" type="String" required>
  Votre clé API unique. Notez que chaque utilisateur possède des clés API uniques pour chaque API Cleariflow ; votre clé de l'API de validation TVA ne fonctionnera pas pour votre API de géolocalisation IP, par exemple.
</ParamField>

<ParamField query="country_code" type="String" required>
  Le code ISO 3166-1 alpha-2 à deux lettres du pays pour lequel vous souhaitez récupérer les catégories de TVA.
</ParamField>

### Paramètres de réponse

La réponse de l'API est renvoyée dans un [format JSON](https://www.json.org/json-en.html) universel et léger.

La réponse est un tableau d'objets de catégorie, où chaque objet contient :

<ResponseField name="country_code" type="String">
  Le code ISO 3166-1 alpha-2 à deux lettres du pays pour lequel les catégories sont renvoyées.
</ResponseField>

<ResponseField name="rate" type="String">
  Le taux de TVA pour cette catégorie spécifique sous forme de chaîne décimale (par ex., « 0.190 » pour 19 %).
</ResponseField>

<ResponseField name="category" type="String">
  Le nom de la catégorie (par ex., « standard », « e-books », « audiobooks »).
</ResponseField>

<ResponseField name="description" type="String">
  Une description de la catégorie et de son applicabilité.
</ResponseField>