Reports

Operations in the Reports group.

Base URLhttps://api.damedoklad.cz/v1Authentication Errors and limits Conventions

GET/v1/overview
GET/v1/reports/aging
GET/v1/reports/cash-flow
GET/v1/reports/export
GET/v1/reports/income-expense
GET/v1/reports/payment-discipline
GET/v1/reports/top-contacts

Get the financial overview: to-do counts, overdue receivables, cash on hand, year result, monthly revenue and expense with a forecast, and breakdowns by account

GET/v1/overview

Get the financial overview: to-do counts, overdue receivables, cash on hand, year result, monthly revenue and expense with a forecast, and breakdowns by account

MCP tool: get-financial-overview

Query parameters

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Response · 200

asOfstringrequireddate-time

regimestringrequired

yearintegerrequired

toDoobjectrequired

totalintegerrequired

documentsintegerrequired

movementsintegerrequired

overdueobjectrequired

amountHalerinteger | nullrequired

countintegerrequired

oldestDaysintegerrequired

oldestBucketnull | stringrequired

moneyobjectrequired

balanceHalerintegerrequired

changePercentinteger | nullrequired

resultnull | objectrequired

amountHalerinteger | nullrequired

revenueHalerintegerrequired

expenseHalerintegerrequired

monthsobject[]required

monthnull | stringrequired

revenueHalerintegerrequired

expenseHalerintegerrequired

forecastnull | objectrequired

monthnull | stringrequired

actualProfitHalerintegerrequired

estimatedProfitHalerintegerrequired

estimatedRevenueHalerintegerrequired

estimatedExpenseHalerintegerrequired

expensesByAccountobject[]required

keystringrequired

labelnull | stringrequired

amountHalerinteger | nullrequired

revenuesByAccountobject[]required

keystringrequired

labelnull | stringrequired

amountHalerinteger | nullrequired

toFinishobject[]required

typestringrequired

countintegerrequired

pathnull | stringrequired

labelnull | string

labelEnstring

kindstring

requiresstring

fromstringdate

tostringdate

periodIdstring

GET/v1/overview

curl https://api.damedoklad.cz/v1/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/overview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/overview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get open receivables or payables by age (not due, 1–30, 31–60, 61–90, over 90 days) in total and per contact

GET/v1/reports/aging

Get open receivables or payables by age (not due, 1–30, 31–60, 61–90, over 90 days) in total and per contact

MCP tool: get-aging-report

Query parameters

kind"receivables" | "payables"default "receivables"

asOfstringYYYY-MM-DD

Date as YYYY-MM-DD.

Response · 200

kindstringrequired

asOfstringrequireddate

bucketsobjectrequired

not_dueintegerrequired

d1_30integerrequired

d31_60integerrequired

d61_90integerrequired

d90_plusintegerrequired

totalHalerinteger | nullrequired

dataobject[]required

contactIdnull | stringrequired

contactNamenull | stringrequired

totalHalerinteger | nullrequired

not_dueintegerrequired

d1_30integerrequired

d31_60integerrequired

d61_90integerrequired

d90_plusintegerrequired

retainedHalerinteger

retainedBucketsobject

not_dueintegerrequired

d1_30integerrequired

d31_60integerrequired

d61_90integerrequired

d90_plusintegerrequired

retainedHalerinteger

GET/v1/reports/aging

curl https://api.damedoklad.cz/v1/reports/aging \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/aging', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/aging",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get money in, money out, and closing balance per month for a year

GET/v1/reports/cash-flow

Get money in, money out, and closing balance per month for a year

MCP tool: get-cash-flow-report

Query parameters

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Response · 200

yearintegerrequired

openingHalerintegerrequired

dataobject[]required

monthnull | stringrequired

inflowHalerintegerrequired

outflowHalerintegerrequired

closingHalerintegerrequired

fromstringdate

tostringdate

GET/v1/reports/cash-flow

curl https://api.damedoklad.cz/v1/reports/cash-flow \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/cash-flow', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/cash-flow",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download a report or document list as XLSX or CSV

GET/v1/reports/export

Download a report or document list as XLSX or CSV

MCP tool: export-report

Query parameters

format"xlsx" | "csv"default "xlsx"

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Response · 200

Returns a application/octet-stream file.

GET/v1/reports/export

curl https://api.damedoklad.cz/v1/reports/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/reports/export', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Get monthly revenue, expense, and result for a year (accrual under double entry, cash under tax records)

GET/v1/reports/income-expense

Get monthly revenue, expense, and result for a year (accrual under double entry, cash under tax records)

MCP tool: get-income-expense-report

Query parameters

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Response · 200

yearintegerrequired

dataobject[]required

monthnull | stringrequired

revenueHalerintegerrequired

expenseHalerintegerrequired

resultHalerintegerrequired

fromstringdate

tostringdate

GET/v1/reports/income-expense

curl https://api.damedoklad.cz/v1/reports/income-expense \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/income-expense', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/income-expense",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get how each customer pays (Platební kázeň): share paid on time, average and longest days late, and what is overdue now

GET/v1/reports/payment-discipline

Get how each customer pays (Platební kázeň): share paid on time, average and longest days late, and what is overdue now. For issued invoices, debit notes, and other receivables of the period, in CZK. Average late days are weighted by amount. A retention falls due on its own date. A set-off counts as paid on its date, an advance as on time.

MCP tool: get-payment-discipline-report

Query parameters

fromstringYYYY-MM-DD

Invoices issued from this day. Defaults to 1 January of the asOf year.

tostringYYYY-MM-DD

Invoices issued up to this day. Defaults to asOf.

asOfstringYYYY-MM-DD

What counts as overdue is read on this day. Defaults to today.

contactIdstring

ID of the contact. Find it with list-contacts.

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

Response · 200

fromstringrequireddate

tostringrequireddate

asOfstringrequireddate

dataobject[]required

contactIdnull | stringrequired

contactNamenull | stringrequired

documentsintegerrequired

settledHalerintegerrequired

lateHalerintegerrequired

maxLateDaysintegerrequired

openHalerintegerrequired

overdueHalerintegerrequired

overdueDaysintegerrequired

averageLateDaysnumberrequired

onTimePercentnull | numberrequired

ratingstringrequired

GET/v1/reports/payment-discipline

curl https://api.damedoklad.cz/v1/reports/payment-discipline \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/payment-discipline', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/payment-discipline",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get the largest customers or suppliers by turnover excluding VAT for a year

GET/v1/reports/top-contacts

Get the largest customers or suppliers by turnover excluding VAT for a year

MCP tool: get-top-contacts-report

Query parameters

kind"customers" | "suppliers"default "customers"

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

Response · 200

kindstringrequired

yearintegerrequired

dataobject[]required

contactIdnull | stringrequired

contactNamenull | stringrequired

documentsintegerrequired

netHalerintegerrequired

totalHalerinteger | nullrequired

hasMorebooleanrequired

fromstringdate

tostringdate

GET/v1/reports/top-contacts

curl https://api.damedoklad.cz/v1/reports/top-contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/top-contacts', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/top-contacts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()