VAT Categories endpoint

The categories endpoint makes it easy to get the latest VAT rates, including the reduced rates for certain categories, for a specific country.

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:

Response

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

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.