VAT Rate

• Allowed query parameters
• Create a VAT rate
• Update a VAT rate
• Retrieve a VAT rate
• Delete a VAT rate
• List VAT rates
• VAT Code Values

Allowed query parameters

Filters

Filter	Type	Description
search	String	Full-text search
vat_code	Integer	Filter by VAT code
is_default	Boolean	Filter by default VAT rate
valid	Date	Filter by rates valid on a specific date (format: YYYY-MM-DD)
vat_type	String	Filter by VAT type (e.g., 'sales_tax', 'input_tax', 'net_tax')

Sorting

name, rate, valid_from, valid_until, vat_code, created_at

Create a VAT rate

post

/vat_rate

Attribute (* required)	Type	Description
name *	String	VAT rate name (max 255 characters)
description	String?	VAT rate description (max 255 characters)
rate *	Number	VAT rate percentage (0-100)
valid_from	Date?	Valid from date (format: YYYY-MM-DD)
valid_until	Date?	Valid until date (format: YYYY-MM-DD, must be after valid_from)
vat_code	Integer?	VAT code enum value
is_default	Boolean	Whether this is the default VAT rate (default: false)

Example response

// HTTP 201 Created
{
    // a vat rate object
}

Update a VAT rate

put

/vat_rate/{id}

Attribute	Type	Description
name	String	VAT rate name (max 255 characters)
description	String?	VAT rate description (max 255 characters)
rate	Number	VAT rate percentage (0-100)
valid_from	Date?	Valid from date (format: YYYY-MM-DD)
valid_until	Date?	Valid until date (format: YYYY-MM-DD, must be after valid_from)
vat_code	Integer?	VAT code enum value
is_default	Boolean	Whether this is the default VAT rate

Example response

// HTTP 200 OK
{
    // a vat rate object
}

Retrieve a VAT rate

get

/vat_rate/{id}

Example response

// HTTP 200 OK
{
    "id": "D4rNdYjlGy",
    "name": "Standard VAT Rate",
    "description": "Standard Swiss VAT rate",
    "label": "Standard VAT Rate 7.7%",
    "short_label": "SSS 7.7%",
    "rate": 7.7,
    "valid_from": "2024-01-01",
    "valid_until": null,
    "vat_code": 303,
    "vat_type": {
        "name": "SalesTax",
        "label": "Sales Tax"
    },
    "is_currently_valid": true,
    "is_default": true,
    "created_at": "2024-01-01T00:00:00.000000Z",
    "updated_at": "2024-01-01T00:00:00.000000Z"
}

Delete a VAT rate

delete

/vat_rate/{id}

Example response

// HTTP 204 No Content

List VAT rates

get

/vat_rate

The list endpoint accepts the same parameters as in Retrieve a VAT rate and returns a paginated array of the same VAT rate object in the data property.

Read more about Pagination, Filtering, Sorting and Includes on the Introduction page.

VAT Code Values

The following VAT codes are available:

Sales Tax Exceptions

• 205 - Sales Tax Except
• 220 - Sales Tax Except Export
• 221 - Sales Tax Except Abroad
• 225 - Sales Tax Except Notification Procedure
• 230 - Sales Tax Except Domestic
• 235 - Sales Tax Except Discounts
• 280 - Sales Tax Except Miscellaneous

Sales Taxes (2024+)

• 303 - Sales Tax Normal
• 313 - Sales Tax Reduced
• 343 - Sales Tax Special
• 383 - Acquisition Tax

Sales Taxes (Until 2023)

• 302 - Sales Tax Normal (2023)
• 312 - Sales Tax Reduced (2023)
• 342 - Sales Tax Special (2023)
• 382 - Acquisition Tax (2023)

Net Tax Rates (2024+)

• 323 - Net Tax Rate 1
• 333 - Net Tax Rate 2

Net Tax Rates (Until 2023)

• 322 - Net Tax Rate 1 (2023)
• 332 - Net Tax Rate 2 (2023)

Input Taxes

• 400 - Input Tax Goods & Services
• 405 - Input Tax Investments & Operations
• 410 - Deposit Control
• 415 - Input Tax Corrections Mixed
• 420 - Input Tax Corrections Non-Remuneration

Non-Remuneration

• 900 - Subsidies Tourism & Waste