Skip to main content
GET
Get VAT categories

Getting started

Base URL

Categories endpoint

The categories endpoint requires your unique API key, and the country you’d like to check:
This successful request returns comprehensive VAT rate information including standard rates and reduced rates with their associated categories:

Request parameters

String
required
Your unique API key. Note that each user has unique API keys for each of Cleariflow APIs, so your VAT Validation API key will not work for as your IP Geolocation API, for example.
String
required
The two letter ISO 3166-1 alpha-2 code of the country for which you want to retrieve VAT categories.

Response parameters

The API response is returned in a universal and lightweight JSON format. The response is an array of category objects, where each object contains:
String
The two letter ISO 3166-1 alpha-2 code of the country for which the categories are returned.
String
The VAT rate for this specific category as a decimal string (e.g., “0.190” for 19%).
String
The name of the category (e.g., “standard”, “e-books”, “audiobooks”).
String
A description about the category and its applicability.

Query Parameters

api_key
string
required

Your unique API key

country_code
string
required

Two-letter ISO 3166-1 alpha-2 country code

Required string length: 2

Response

Successful response

country_code
string

Two-letter country code

rate
string

VAT rate as decimal string

category
string

Category name

description
string

Category description