Calculate tax rate
calculate_taxRead-only
Calculate the correct tax rate/amount for a sale given the customer's location and product. This is Quaderno's flagship endpoint — it applies the right VAT / GST / US sales-tax rules per jurisdiction. READ-ONLY (no record is created). Quaderno API: GET /tax_rates/calculate. Returns { name, rate, country, region, county, city, tax_code, status (taxable|non_taxable|not_registered|reverse_charge), tax_amount, subtotal, total_amount }.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Transaction date (YYYY-MM-DD); defaults to today. | |
| amount | No | Transaction amount to compute the tax on. | |
| tax_id | No | The customer's tax ID / VAT number (may trigger reverse-charge). | |
| to_city | No | The customer's city (recommended for US sales tax). | |
| currency | No | ISO 4217 currency code (e.g. "USD"). | |
| tax_code | No | Product tax code, e.g. "standard", "reduced", "exempt", "eservice", "ebook", "saas", "consulting". | |
| to_street | No | The customer's street address (recommended for US sales tax). | |
| to_country | Yes | The customer's country — 2-letter ISO code (e.g. "US", "DE"). Required. | |
| from_country | No | The seller's country (2-letter ISO); defaults to the account country. | |
| product_type | No | Whether the product is a good or a service. | |
| tax_behavior | No | Whether the amount includes tax or not. | |
| to_postal_code | No | The customer's ZIP / postal code (recommended for US sales tax). | |
| from_postal_code | No | The seller's postal code. |