Skip to main content
GET
/
v1
/
calculate
/
Calculate VAT endpoint
curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/
{
    "amount_excluding_vat": "175.00",
    "amount_including_vat": "208.25",
    "country": {
        "code": "DE",
        "name": "Germany"
    },
    "vat_amount": "33.25",
    "vat_category": "standard",
    "vat_rate": "0.190"
}

​
Getting started

​
Base URL

https://vat.cleariflow.com/v1/calculate/

​
Calculation endpoint

The calculate endpoint requires your unique API key, the country and the price you’d like to check: 
https://vat.cleariflow.com/v1/calculate/
? api_key = YOUR_UNIQUE_API_KEY
& amount = 175  
& country_code = DE
& category = standard
This successful request returns comprehensive VAT calculation results including rates, amounts, and country information: 
{
    "amount_excluding_vat": "175.00",
    "amount_including_vat": "208.25",
    "country": {
        "code": "DE",
        "name": "Germany"
    },
    "vat_amount": "33.25",
    "vat_category": "standard",
    "vat_rate": "0.190"
}

​
Request parameters

​
api_key
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.
​
amount
String
required
The amount that you would like to get the VAT amount for or from.
​
country_code
String
required
The two letter ISO 3166-1 alpha-2 code of the country in which the transaction takes place.
​
category
String
required
The VAT category to use for calculation. Use “standard” for standard VAT rate, or specific categories like “e-books”, “audiobooks”, etc. for reduced rates.
​
is_vat_incl
Boolean
If the amount already has VAT added and you’d like to do the reverse calculation and split out the amount and VAT, set this parameter to true. If this parameter is not explicitly included it will default to false.

​
Response parameters

The API response is returned in a universal and lightweight JSON format.
​
amount_excluding_vat
String
The amount excluding the VAT.
​
amount_including_vat
String
The sum of the base amount and the VAT, i.e., amount_excluding_vat + vat_amount.
​
vat_amount
String
The calculated amount of VAT.
​
vat_category
String
The category of the purchase, used to determine whether it qualifies for a reduced rate. See below for a list of supported categories.
​
vat_rate
String
The VAT rate as a decimal string (e.g., “0.190” for 19%).
​
country
Object
Object containing country information.
​
country.code
String
The two letter ISO 3166-1 alpha-2 code of the country in which the transaction takes place.
​
country.name
String
The name of the country the VAT is being calculated from.