Passer au contenu principal
GET
/
v1
/
categories
Endpoint des catégories TVA
curl --request GET \
  --url https://vat.cleariflow.com/v1/categories/
[
    {
        "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"
    }
]

​
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 : 
[
    {
        "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"
    }
]

​
Paramètres de requête

​
api_key
String
requis
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.
​
country_code
String
requis
Le code ISO 3166-1 alpha-2 à deux lettres du pays pour lequel vous souhaitez récupérer les catégories de TVA.

​
Paramètres de réponse

La réponse de l’API est renvoyée dans un format JSON universel et léger. La réponse est un tableau d’objets de catégorie, où chaque objet contient :
​
country_code
String
Le code ISO 3166-1 alpha-2 à deux lettres du pays pour lequel les catégories sont renvoyées.
​
rate
String
Le taux de TVA pour cette catégorie spécifique sous forme de chaîne décimale (par ex., « 0.190 » pour 19 %).
​
category
String
Le nom de la catégorie (par ex., « standard », « e-books », « audiobooks »).
​
description
String
Une description de la catégorie et de son applicabilité.