​
Description

The VatAPI.categories() method is used to communicate with this endpoint as seen below:

VatAPI.categories(country_code)

​
Query Parameters

​
country_code
String
required

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

​
Usage

Below is a code snippet to query the VatAPI.categories() method:

from abstract_python import VatAPI

api_key = "your-vat-api-key"

api = VatAPI(api_key)
country_code = "BE"
response = api.categories(country_code)

print(response)

Below is the response object:

[
    {
    'country_code': 'BE', 
    'rate': '0.000', 
    'category': 'newspapers', 
    'description': "Supply, including on loan by libraries, of books, newspapers and 
                    periodicals either on physical means of support or supplied electronically or both 
                    (including brochures, leaflets and similar printed matter, children's picture, drawing or colouring books, music printed or in manuscript form, 
                    maps and hydrographic or similar charts), other than publications wholly or predominantly devoted to advertising and other than publications wholly 
                    or predominantly consisting of video content or audible music. Newspapers and some periodical publications under the conditions provided for in Royal 
                    Decree N° 20, Table C, category I (on paper and digital) and that do not fall under the mentionned exceptions\nThe reduced rate only applies for 
                    those goods in 4902."
    },
    
    .....

    {'status': 200}
]

​
Response Fields

​
country_code
String

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

​
rate
String

The VAT rate for this specific category.

​
category
String

The name of the category.

​
description
String

A description about the category.