Accounting

List available tax codes

Lists the VAT tax codes that can be used in the taxCode field of ledger entries on a given date.

Which tax codes are available depends on the organisation’s VAT settings for that date:

Without VAT, no tax codes are available.
With the effective method, the statutory tax codes at the rates in force on that date are available (e.g. UN81 from 2024 on, UN77 before).
With the simplified method (Saldosteuersatz), the organisation’s own simplified tax codes (e.g. SS53) are available, along with the statutory codes that keep their meaning under the simplified method, such as UEX or BZB81.

GET

tax-codes

List available tax codes

curl --request GET \
  --url https://api.infinity.swiss/v1/tax-codes \
  --header 'x-api-token: <api-key>'

const options = {method: 'GET', headers: {'x-api-token': '<api-key>'}};

fetch('https://api.infinity.swiss/v1/tax-codes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/tax-codes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/tax-codes"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/tax-codes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "taxCodes": [
    {
      "code": "UN81",
      "name": "Umsatz (NS)",
      "rate": 8.1,
      "type": "sales-tax",
      "statutoryRate": 8.1,
      "isDefault": true
    }
  ]
}

{
  "code": "<string>",
  "invalidFields": [
    "<string>"
  ]
}

{
  "code": "general/unauthorised"
}

Choosing a tax code

Use this endpoint to find out which values are accepted in the taxCode field when posting a ledger entry. The available tax codes depend on the organisation’s VAT settings and on the statutory VAT rates in force on the date of the booking, so pass the booking date as the date parameter:

curl "https://api.infinity.swiss/v1/tax-codes?date=2025-03-01" \
  -H "x-api-token: your-api-token"

If the organisation is not subject to VAT, the list is empty and ledger entries should be posted without a tax code.
With the effective method, the statutory tax codes are returned at the rates that apply on the given date, e.g. UN81 for the normal rate of 8.1% from 2024 on.
With the simplified method (Saldosteuersatz), the organisation’s own simplified tax codes such as SS53 are returned, together with the statutory codes that keep their meaning under the simplified method (e.g. UEX for exports or BZB81 for reverse charge). The default simplified tax code is marked with isDefault.

For a full explanation of every statutory tax code, see “Liste der MWST-Codes“.

Authorizations

x-api-token

string

header

required

API token for authentication. Obtain from your Infinity account settings.

Query Parameters

date

string<date>

The date for which to list the available tax codes in YYYY-MM-DD format. Defaults to today.

Response

The tax codes that can be used for ledger entries on the given date.

taxCodes

AvailableTaxCode · object[]

required

Show child attributes

List available tax codes

curl --request GET \
  --url https://api.infinity.swiss/v1/tax-codes \
  --header 'x-api-token: <api-key>'

const options = {method: 'GET', headers: {'x-api-token': '<api-key>'}};

fetch('https://api.infinity.swiss/v1/tax-codes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/tax-codes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/tax-codes"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/tax-codes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "taxCodes": [
    {
      "code": "UN81",
      "name": "Umsatz (NS)",
      "rate": 8.1,
      "type": "sales-tax",
      "statutoryRate": 8.1,
      "isDefault": true
    }
  ]
}

{
  "code": "<string>",
  "invalidFields": [
    "<string>"
  ]
}

{
  "code": "general/unauthorised"
}

For developers

Accounting

Chart of accounts

Receipts

Contacts

Invoices

Estimates

Projects

Work entries

List available tax codes

Choosing a tax code

Authorizations

Query Parameters

Response

​Choosing a tax code

Authorizations

Query Parameters

Response

Choosing a tax code