GET
/
v1
/
categories
Query
curl --request GET \
  --url https://vat.abstractapi.com/v1/categories
[
    {
        "country_code": "DE",
        "rate": "0.070",
        "category": "water",
        "description": "Supply of water. No reduced rate for bottled water..."
    },
    {
        "country_code": "DE",
        "rate": "0.070",
        "category": "foodstuffs",
        "description": "Foodstuffs (including beverages but excluding alcoholic beverages) for human..."
    },
    {
        "country_code": "DE",
        "rate": "0.070",
        "category": "sculpture art",
        "description": "Original sculptures and statuary, in any material, provided..."
    },
    {
        "country_code": "DE",
        "rate": "0.070",
        "category": "social welfare goods",
        "description": "Supply of goods and services by organisations recognised as being..."
    },
    
    ..................

    {
        "country_code": "DE",
        "rate": "0.190",
        "category": "standard",
        "description": ""
    },
    {
        "country_code":..."
        "rate": "0.070",
        "category": "books",
        "description": "Supply, including on loan by libraries, of books..."
    },
    {
        "country_code": "DE",
        "rate": "0.070",
        "category": "picture art",
        "description": "Pictures, collages and similar decorative plaques, paintings and..."
    }
]

Getting started

Base URL

https://vat.abstractapi.com/v1/categories

Validation endpoint

The categories endpoint simply requires your unique API key, and the country you’d like to check:

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

This was a successful request, and the response includes both the standard rate as well as the reduces rates and categories associated with them:

Request parameters

api_key
String
required

Your unique API key. Note that each user has unique API keys for each of Abstract’s APIs, so your VAT Validation API key will not work for as your IP Geolocation API, for example.

country_code
String
required

The two letter ISO 3166-1 alpha-2 code of the country in which the transaction takes place.

Response parameters

The API response is returned in a universal and lightweight JSON format.

country_code
String

The two letter ISO 3166-1 alpha-2 code of the country in which the transaction takes place, which is returned from the request.

rate
String

The VAT rate for this specific category.

category
String

The name of the category.

description
String

A description about the category.