> ## 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 de categorías de IVA

> El endpoint `categories` proporciona acceso completo a las tasas de IVA actuales y a las categorías fiscales de países específicos, incluidas tasas reducidas para bienes y servicios que califiquen, para garantizar un cumplimiento fiscal preciso.

## Primeros pasos

### URL base

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

### Endpoint de categorías

El endpoint `categories` requiere su clave API única y el país que desea consultar:

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

Esta solicitud exitosa devuelve información completa sobre las tasas de IVA, incluidas las tasas estándar y reducidas con sus categorías asociadas:

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

### Parámetros de solicitud

<ParamField query="api_key" type="String" required>
  Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de validación de IVA no funcionará para su API de geolocalización IP, por ejemplo.
</ParamField>

<ParamField query="country_code" type="String" required>
  El código ISO 3166-1 alpha-2 de dos letras del país para el que desea recuperar las categorías de IVA.
</ParamField>

### Parámetros de respuesta

La respuesta de la API se devuelve en un [formato JSON](https://www.json.org/json-en.html) universal y ligero.

La respuesta es una matriz de objetos de categoría, donde cada objeto contiene:

<ResponseField name="country_code" type="String">
  El código ISO 3166-1 alpha-2 de dos letras del país para el que se devuelven las categorías.
</ResponseField>

<ResponseField name="rate" type="String">
  La tasa de IVA para esta categoría específica como cadena decimal (p. ej., "0.190" para el 19 %).
</ResponseField>

<ResponseField name="category" type="String">
  El nombre de la categoría (p. ej., "standard", "e-books", "audiobooks").
</ResponseField>

<ResponseField name="description" type="String">
  Una descripción de la categoría y su aplicabilidad.
</ResponseField>