List account balances

GET

accounts

balances

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

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

fetch('https://api.infinity.swiss/v1/accounts/balances', 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/accounts/balances",
  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/accounts/balances"

	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/accounts/balances")

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

{
  "date": "2025-06-30",
  "fiscalYear": {
    "id": "686f1b2ce9500b3ffe4bbc71",
    "from": "2025-01-01",
    "to": "2025-12-31",
    "isClosed": true
  },
  "balances": [
    {
      "number": 1020,
      "name": "Bank",
      "type": "assets",
      "balance": 125000,
      "fx": {
        "balance": 98000,
        "currency": "EUR"
      }
    }
  ]
}

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

{
  "code": "general/unauthorised"
}

{
  "code": "<string>",
  "accountNumbers": [
    1099
  ]
}

Balances at a date

Pass the date you are interested in to receive the balance of every account at the end of that day:

curl "https://api.infinity.swiss/v1/accounts/balances?date=2025-06-30" \
  -H "x-api-token: your-api-token"

To read only some accounts, list their numbers in accounts:

curl "https://api.infinity.swiss/v1/accounts/balances?date=2025-06-30&accounts=1020,1100,3200" \
  -H "x-api-token: your-api-token"

{
  "date": "2025-06-30",
  "fiscalYear": {
    "id": "686f1b2ce9500b3ffe4bbc71",
    "from": "2025-01-01",
    "to": "2025-12-31",
    "isClosed": false
  },
  "balances": [
    { "number": 1020, "name": "Bank", "type": "assets", "balance": 1250000 },
    {
      "number": 1100,
      "name": "Accounts receivable",
      "type": "assets",
      "balance": 430000
    },
    {
      "number": 3200,
      "name": "Revenue from services",
      "type": "income",
      "balance": 2180000
    }
  ]
}

Reading the balances

Amounts are integers in cents, so 1250000 means 12,500.00. balance is in CHF; foreign currency accounts additionally report their balance in their own currency under fx, also in cents.
A balance is positive in the account’s normal direction: a debit balance for assets and expenses, a credit balance for liabilities and income.
Balances are calculated within the fiscal year that contains the date. Balance sheet accounts include their opening balance, while income and expense accounts count from the start of that fiscal year. A date outside every fiscal year returns fiscal-year/not-found.
The closing entries of a fiscal year are left out, so the balances of a closed fiscal year still show its result.

Authorizations

x-api-token

string

header

required

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

Query Parameters

date

string<date>

The date whose closing balances to return in YYYY-MM-DD format. Must lie within a fiscal year. Defaults to today.

accounts

string

Only return the balances of these accounts, as a comma-separated list of account numbers. Returns the whole chart of accounts if omitted.

Pattern: ^\d{4}(,\d{4})*$

Response

The balances of the requested accounts at the end of the given date, sorted by account number.

date

string<date>

required

The date the balances apply to in YYYY-MM-DD format. Every ledger entry dated on or before this day is included.

Example:

"2025-06-30"

fiscalYear

FiscalYear · object

required

A fiscal year of the organisation.

Show child attributes

balances

AccountBalance · object[]

required

Show child attributes

List account balances

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

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

fetch('https://api.infinity.swiss/v1/accounts/balances', 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/accounts/balances",
  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/accounts/balances"

	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/accounts/balances")

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

{
  "date": "2025-06-30",
  "fiscalYear": {
    "id": "686f1b2ce9500b3ffe4bbc71",
    "from": "2025-01-01",
    "to": "2025-12-31",
    "isClosed": true
  },
  "balances": [
    {
      "number": 1020,
      "name": "Bank",
      "type": "assets",
      "balance": 125000,
      "fx": {
        "balance": 98000,
        "currency": "EUR"
      }
    }
  ]
}

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

{
  "code": "general/unauthorised"
}

{
  "code": "<string>",
  "accountNumbers": [
    1099
  ]
}

For developers

MCP server

Accounting

Chart of accounts

Receipts

Contacts

Invoices

Estimates

Projects

Work entries

Balances at a date

Reading the balances

Authorizations

Query Parameters

Response

​Balances at a date

​Reading the balances

Authorizations

Query Parameters

Response

Balances at a date

Reading the balances