> ## 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 categorie IVA

> L'endpoint `categories` fornisce accesso completo alle aliquote IVA attuali e alle categorie fiscali per paesi specifici, incluse aliquote ridotte per beni e servizi qualificanti, per garantire una conformità fiscale accurata.

## Per iniziare

### URL di base

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

### Endpoint categorie

L'endpoint `categories` richiede la tua chiave API univoca e il paese da verificare:

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

Questa richiesta riuscita restituisce informazioni complete sulle aliquote IVA incluse aliquote standard e ridotte con le relative categorie:

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

### Parametri della richiesta

<ParamField query="api_key" type="String" required>
  La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche per ciascuna delle API Cleariflow, quindi la chiave dell'API di validazione IVA non funzionerà per l'API di geolocalizzazione IP, ad esempio.
</ParamField>

<ParamField query="country_code" type="String" required>
  Il codice ISO 3166-1 alpha-2 a due lettere del paese per cui desideri recuperare le categorie IVA.
</ParamField>

### Parametri della risposta

La risposta API viene restituita in un [formato JSON](https://www.json.org/json-en.html) universale e leggero.

La risposta è un array di oggetti categoria, dove ogni oggetto contiene:

<ResponseField name="country_code" type="String">
  Il codice ISO 3166-1 alpha-2 a due lettere del paese per cui vengono restituite le categorie.
</ResponseField>

<ResponseField name="rate" type="String">
  L'aliquota IVA per questa categoria specifica come stringa decimale (es. "0.190" per il 19%).
</ResponseField>

<ResponseField name="category" type="String">
  Il nome della categoria (es. "standard", "e-books", "audiobooks").
</ResponseField>

<ResponseField name="description" type="String">
  Una descrizione della categoria e della sua applicabilità.
</ResponseField>