Zum Hauptinhalt springen
GET
/
v1
/
categories
VAT-Kategorien-Endpunkt
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"
    }
]

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

​
Anfrageparameter

​
api_key
String
erforderlich
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.
​
country_code
String
erforderlich
Der zweistellige ISO-3166-1-alpha-2-Code des Landes, für das VAT-Kategorien abgerufen werden sollen.

​
Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben. Die Antwort ist ein Array von Kategorieobjekten, wobei jedes Objekt Folgendes enthält:
​
country_code
String
Der zweistellige ISO-3166-1-alpha-2-Code des Landes, für das die Kategorien zurückgegeben werden.
​
rate
String
Der VAT-Satz für diese Kategorie als Dezimalzeichenkette (z. B. „0.190” für 19 %).
​
category
String
Der Name der Kategorie (z. B. „standard”, „e-books”, „audiobooks”).
​
description
String
Eine Beschreibung der Kategorie und ihrer Anwendbarkeit.