List all VAT rates

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.

GET/administration/vat-rates

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200

Array of VatRateResponseDto

dateFromstring<date-time>required

The effective start date for this VAT rate in ISO 8601 format. This date determines when the rate becomes active. The system uses this date to select the correct VAT rate when creating invoices and quotes. The rate with the most recent dateFrom that is less than or equal to the document creation date is used.

idstringrequired

Unique identifier (UUID) for the VAT rate. Use this ID to update or delete the rate. This ID is generated automatically when the rate is created.

isDefaultbooleanrequired

Indicates whether this VAT rate is marked as the default rate for the workspace. Default rates cannot be deleted and typically serve as a fallback option. When true, this rate is protected from deletion operations.

vatnumberrequired

The VAT (Value Added Tax) rate percentage currently configured. This is a number between 0 and 100, where 21 represents 21% tax. This is the percentage that will be applied to invoices and quotes created on or after the effective date.

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/administration/vat-rates" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/administration/vat-rates", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/administration/vat-rates",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "dateFrom": "2024-01-01T00:00:00.000Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isDefault": false,
    "vat": 21
  }
]