Developers
Recipes

VAT

Read VAT codes and the rate for a date from the business, and do not hardcode either.

VAT codes and rates depend on the business. Read them. Do not copy a percentage or a code into the client.

NeedCall
Codes the business can useConstants - VAT codes GET /v1/business/{business_slug}/constants/vat_codes/
Rates on a dateConstants - VAT rates by date

The rates operation takes date_at as YYYY-MM-DD. The description's example shape is 2026-01-31. Omit the date only if you have read the reference and it allows that. Cache the response for that business and that date, not as a global table.

A product requires vat_code and vat_rate. Take vat_code from the codes operation. The product schema says to see constants_vat_codes_retrieve for the values that business allows.

A VAT statement for a period is a report, not this constant. See Reports. A VAT period resource is VAT periods - List. It is not the rate table.