---
search:
  tags:
    - administration
    - GET
seo:
  description: >-
    Retrieves all VAT (Value Added Tax) rates configured for the workspace.
    Reference for the GET /administration/vat-rates endpoint in the Leadtime
    Public API API.
sidebar:
  badge: GET
  label: List all VAT rates
title: List all VAT rates
type: openapi-operation
---
Retrieves all VAT (Value Added Tax) rates configured for the workspace.

**What are VAT rates?**
VAT rates determine the tax percentage applied to invoices and quotes. Since tax rates can change by law, Leadtime allows you to configure multiple VAT periods with different effective dates. The system automatically uses the correct rate based on the date when creating invoices and quotes.

**What is returned:**
- All VAT rates for the workspace, sorted by effective date (dateFrom)
- Each rate includes: ID, VAT percentage (0-100), effective start date, and whether it is the default rate

**How VAT rates work:**
- When creating an invoice or quote, the system finds the VAT rate with the most recent dateFrom that is less than or equal to the current date
- Documents that have already been issued keep their original tax rate
- You can plan future VAT changes by creating rates with future effective dates

**Note:** This endpoint requires the WsSettings.manageSettings permission.

<Operation source="api-reference" id="vatratescontroller-listvatrates" />
