Banka a pokladna

Operace ve skupině Banka a pokladna.

Základní URLhttps://api.damedoklad.cz/v1Přihlášení Chyby a limity Konvence

GET/v1/bank-accounts
POST/v1/bank-accounts
GET/v1/bank-accounts/{id}
PATCH/v1/bank-accounts/{id}
DEL/v1/bank-accounts/{id}
PUT/v1/bank-accounts/{id}/fio
POST/v1/bank-accounts/{id}/fio/sync
GET/v1/bank-categories
GET/v1/bank-collectable-documents
GET/v1/bank-movements
POST/v1/bank-movements
GET/v1/bank-movements/{id}
POST/v1/bank-movements/{id}/classify
POST/v1/bank-movements/{id}/match
POST/v1/bank-movements/{id}/release-rest
POST/v1/bank-movements/{id}/unmatch
POST/v1/bank-movements/auto-match
GET/v1/bank-open-documents
POST/v1/bank-opening-balances/post
GET/v1/bank-overview
GET/v1/bank-payable-invoices
GET/v1/bank-rules
POST/v1/bank-rules
PATCH/v1/bank-rules/{id}
DEL/v1/bank-rules/{id}
GET/v1/bank-statements
POST/v1/bank-statements/import
POST/v1/bank-statements/inspect-csv
GET/v1/card-settlements
GET/v1/card-settlements/{id}
DEL/v1/card-settlements/{id}
POST/v1/card-settlements/{id}/post
POST/v1/card-settlements/import
GET/v1/card-settlements/settings
PATCH/v1/card-settlements/settings
GET/v1/cash-documents
POST/v1/cash-documents
GET/v1/cash-documents/{id}
POST/v1/cash-documents/{id}/cancel
GET/v1/cash-documents/{id}/pdf
GET/v1/cash-registers
POST/v1/cash-registers
GET/v1/cash-registers/{id}
PATCH/v1/cash-registers/{id}
DEL/v1/cash-registers/{id}
GET/v1/payment-orders
POST/v1/payment-orders
GET/v1/payment-orders/{id}
POST/v1/payment-orders/{id}/cancel
GET/v1/payment-orders/{id}/export
POST/v1/payment-orders/check
GET/v1/sepa-mandates
POST/v1/sepa-mandates
PATCH/v1/sepa-mandates/{id}
POST/v1/spayd

Seznam: bankovní účty

GET/v1/bank-accounts

List own bank accounts with current balance and the number of unmatched movements

Nástroj MCP: list-bank-accounts

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

Odpověď · 200

dataobject[]povinné

object"bank_account"povinné

idstringpovinné

contactIdnull | string

labelnull | string

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

currencystringpovinné

isDefaultbooleanpovinné

publishedFromRegistryboolean

bicnull | string

bankNamenull | string

bankStreetstring | null

bankCitystring | null

namestring

swiftnull | string

ledgerAccountstring

isActiveboolean

openingBalanceHalerinteger

openingDatenull | stringdate

openingExchangeRatestring | null

openingStatestring

bankBalanceHalerinteger | null

bankBalanceOnnull | stringdate

fioobject

configuredbooleanpovinné

enabledbooleanpovinné

lastSyncedAtnull | stringpovinnédate-time

lastSyncedOnnull | stringpovinnédate

lastErrornull | stringpovinné

createdAtstringdate-time

balanceHalerinteger

unmatchedCountinteger

balanceDiffHalerinteger | null

sepaCreditorIdnull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-accounts

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts', {
  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/bank-accounts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: bankovní účet

POST/v1/bank-accounts

Create a bank account. The analytic 221xxx account and the IBAN are filled in when omitted. A stated opening balance posts MD 221xxx / D 701, or the opening bank of the peněžní deník, unless opening entries already hold the account

Nástroj MCP: create-bank-account

Tělo požadavku

namestringpovinnémax 200 chars

accountNumberstringpovinné

Account number from the chart of accounts, for example 311. list-accounts lists them.

bankCodestringpovinné

ibanstringmax 42 chars

IBAN without spaces.

swiftstring

sepaCreditorIdstringmin 5 charsmax 35 chars

Identifier of the creditor in SEPA direct debit (CID), issued through the bank

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

ledgerAccountstring

isDefaultboolean

openingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

openingDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

openingExchangeRatenumbermax 100000

Odpověď · 201

idstringpovinné

contactIdnull | string

labelnull | string

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

currencystringpovinné

isDefaultbooleanpovinné

publishedFromRegistryboolean

bicnull | string

bankNamenull | string

bankStreetstring | null

bankCitystring | null

namestring

swiftnull | string

ledgerAccountstring

isActiveboolean

openingBalanceHalerinteger

openingDatenull | stringdate

openingExchangeRatestring | null

openingStatestring

bankBalanceHalerinteger | null

bankBalanceOnnull | stringdate

fioobject

configuredbooleanpovinné

enabledbooleanpovinné

lastSyncedAtnull | stringpovinnédate-time

lastSyncedOnnull | stringpovinnédate

lastErrornull | stringpovinné

createdAtstringdate-time

balanceHalerinteger

unmatchedCountinteger

balanceDiffHalerinteger | null

sepaCreditorIdnull | string

POST/v1/bank-accounts

curl -X POST https://api.damedoklad.cz/v1/bank-accounts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "accountNumber": "string",
  "bankCode": "0100"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "accountNumber": "string",
    "bankCode": "0100"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-accounts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "accountNumber": "string",
        "bankCode": "0100"
    },
)
data = response.json()

Detail: bankovní účet

GET/v1/bank-accounts/{id}

Get one bank account

Nástroj MCP: get-bank-account

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

contactIdnull | string

labelnull | string

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

currencystringpovinné

isDefaultbooleanpovinné

publishedFromRegistryboolean

bicnull | string

bankNamenull | string

bankStreetstring | null

bankCitystring | null

namestring

swiftnull | string

ledgerAccountstring

isActiveboolean

openingBalanceHalerinteger

openingDatenull | stringdate

openingExchangeRatestring | null

openingStatestring

bankBalanceHalerinteger | null

bankBalanceOnnull | stringdate

fioobject

configuredbooleanpovinné

enabledbooleanpovinné

lastSyncedAtnull | stringpovinnédate-time

lastSyncedOnnull | stringpovinnédate

lastErrornull | stringpovinné

createdAtstringdate-time

balanceHalerinteger

unmatchedCountinteger

balanceDiffHalerinteger | null

sepaCreditorIdnull | string

GET/v1/bank-accounts/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: bankovní účet

PATCH/v1/bank-accounts/{id}

Update a bank account. Currency and the analytic account are locked once movements are paired. A changed opening balance reverses what it posted and posts anew

Nástroj MCP: update-bank-account

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

accountNumberstring

Account number from the chart of accounts, for example 311. list-accounts lists them.

bankCodestring

ibanstring | null

IBAN without spaces.

swiftstring | null

sepaCreditorIdstringmin 5 charsmax 35 chars

Identifier of the creditor in SEPA direct debit (CID), issued through the bank

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

ledgerAccountstring

isDefaultboolean

openingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

openingDatestring | null

Date as YYYY-MM-DD.

openingExchangeRatenumbermax 100000

isActiveboolean

Odpověď · 200

idstringpovinné

contactIdnull | string

labelnull | string

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

currencystringpovinné

isDefaultbooleanpovinné

publishedFromRegistryboolean

bicnull | string

bankNamenull | string

bankStreetstring | null

bankCitystring | null

namestring

swiftnull | string

ledgerAccountstring

isActiveboolean

openingBalanceHalerinteger

openingDatenull | stringdate

openingExchangeRatestring | null

openingStatestring

bankBalanceHalerinteger | null

bankBalanceOnnull | stringdate

fioobject

configuredbooleanpovinné

enabledbooleanpovinné

lastSyncedAtnull | stringpovinnédate-time

lastSyncedOnnull | stringpovinnédate

lastErrornull | stringpovinné

createdAtstringdate-time

balanceHalerinteger

unmatchedCountinteger

balanceDiffHalerinteger | null

sepaCreditorIdnull | string

PATCH/v1/bank-accounts/{id}

curl -X PATCH https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "accountNumber": "string",
  "bankCode": "0100"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "accountNumber": "string",
    "bankCode": "0100"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "accountNumber": "string",
        "bankCode": "0100"
    },
)
data = response.json()

Smazání: bankovní účet

DELETE/v1/bank-accounts/{id}

Delete a bank account that has no movements, statements, or payment orders. Its posted opening balance is reversed

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-bank-account

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/bank-accounts/{id}

curl -X DELETE https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Save the Fio API token of an account and turn automatic sync on or off. The token is stored encrypted and never returned

PUT/v1/bank-accounts/{id}/fio

Save the Fio API token of an account and turn automatic sync on or off. The token is stored encrypted and never returned

Nástroj MCP: update-bank-account-fio

Parametry v cestě

idstringpovinné

Tělo požadavku

tokenstring

enabledboolean

Odpověď · 200

idstringpovinné

contactIdnull | string

labelnull | string

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

currencystringpovinné

isDefaultbooleanpovinné

publishedFromRegistryboolean

bicnull | string

bankNamenull | string

bankStreetstring | null

bankCitystring | null

namestring

swiftnull | string

ledgerAccountstring

isActiveboolean

openingBalanceHalerinteger

openingDatenull | stringdate

openingExchangeRatestring | null

openingStatestring

bankBalanceHalerinteger | null

bankBalanceOnnull | stringdate

fioobject

configuredbooleanpovinné

enabledbooleanpovinné

lastSyncedAtnull | stringpovinnédate-time

lastSyncedOnnull | stringpovinnédate

lastErrornull | stringpovinné

createdAtstringdate-time

balanceHalerinteger

unmatchedCountinteger

balanceDiffHalerinteger | null

sepaCreditorIdnull | string

PUT/v1/bank-accounts/{id}/fio

curl -X PUT https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "token": "string",
  "enabled": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "token": "string",
    "enabled": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "token": "string",
        "enabled": False
    },
)
data = response.json()

Download new movements of a Fio account now. Fio allows one call per token in 30 seconds

POST/v1/bank-accounts/{id}/fio/sync

Download new movements of a Fio account now. Fio allows one call per token in 30 seconds

Nástroj MCP: sync-bank-account-fio

Parametry v cestě

idstringpovinné

Odpověď · 200

bankAccountIdstringpovinné

fromstringpovinnédate

tostringpovinnédate

importedCountintegerpovinné

duplicateCountintegerpovinné

autoMatchedCountintegerpovinné

closingBalanceHalerinteger | nullpovinné

warningsany[]povinné

POST/v1/bank-accounts/{id}/fio/sync

curl -X POST https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio/sync \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio/sync', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-accounts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fio/sync",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

The predefined choices for movements without a document: bank fee, interest, taxes, own transfer

GET/v1/bank-categories

The predefined choices for movements without a document: bank fee, interest, taxes, own transfer

Nástroj MCP: list-bank-categories

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"bank_category"povinné

idstringpovinné

directionstringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

nameCsstringpovinné

nameEnnull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-categories

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-categories', {
  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/bank-categories",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Unpaid issued invoices, debit notes, and other receivables ready for a příkaz k inkasu. `hasBankAccount` tells whether the customer has a Czech account, `mandates` how many active SEPA mandates

GET/v1/bank-collectable-documents

Unpaid issued invoices, debit notes, and other receivables ready for a příkaz k inkasu. `hasBankAccount` tells whether the customer has a Czech account, `mandates` how many active SEPA mandates

Nástroj MCP: list-collectable-documents

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

dueTostringYYYY-MM-DD

Date as YYYY-MM-DD.

dueFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

Odpověď · 200

dataobject[]povinné

object"collectable_document"povinné

kindstringpovinné

idstringpovinné

numbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

variableSymbolnull | stringpovinné

dueDatenull | stringpovinnédate

currencynull | stringpovinné

totalHalerinteger | nullpovinné

remainingHalerinteger | nullpovinné

hasBankAccountbooleanpovinné

mandatesintegerpovinné

inPaymentbooleanpovinné

paymentOrderIdnull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-collectable-documents

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-collectable-documents', {
  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/bank-collectable-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List bank movements across accounts with their pairing and suggested matches. status=open means anything not fully paired

GET/v1/bank-movements

List bank movements across accounts with their pairing and suggested matches. status=open means anything not fully paired

Nástroj MCP: list-bank-movements

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"unmatched" | "partial" | "matched" | "non_document" | "open"

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

statementIdstring

ID of the statement.

Odpověď · 200

dataobject[]povinné

object"bank_movement"povinné

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-movements

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements', {
  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/bank-movements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add one movement by hand, for a bank that gives no export

POST/v1/bank-movements

Add one movement by hand, for a bank that gives no export

Nástroj MCP: create-bank-movement

Tělo požadavku

bankAccountIdstringpovinné

ID of the bank account. Find it with list-bank-accounts.

bookedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

amountHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

counterpartyAccountstringmax 42 chars

counterpartyBankCodestring

counterpartyNamestringmax 200 chars

variableSymbolstring

constantSymbolstring

specificSymbolstring

messagestringmax 400 chars

Odpověď · 201

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

POST/v1/bank-movements

curl -X POST https://api.damedoklad.cz/v1/bank-movements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "bookedOn": "2026-10-30",
  "amountHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "bookedOn": "2026-10-30",
    "amountHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "bookedOn": "2026-10-30",
        "amountHaler": 1210000
    },
)
data = response.json()

Get one bank movement with its pairing and suggestions

GET/v1/bank-movements/{id}

Get one bank movement with its pairing and suggestions

Nástroj MCP: get-bank-movement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

GET/v1/bank-movements/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Book a movement without a document: bank fee, interest, tax payment, transfer between own accounts, or a chosen account

POST/v1/bank-movements/{id}/classify

Book a movement without a document: bank fee, interest, tax payment, transfer between own accounts, or a chosen account

Nástroj MCP: classify-bank-movement

Parametry v cestě

idstringpovinné

Tělo požadavku

amountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

accountNumberstring

Account number from the chart of accounts, for example 311. list-accounts lists them.

classification"income_taxable" | "income_nontax" | "expense_deductible" | "expense_nontax" | "transfer"

counterBankAccountIdstring

ID of the counter bank account.

exchangeRatenumbermax 100000

feeHalerintegermax 9007199254740991

For category card_settlement: what the provider kept. The clearing account clears by the payout and this, and this goes on the fee account

notestringmax 2000 chars

pairingSymbolstringmax 32 chars

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

POST/v1/bank-movements/{id}/classify

curl -X POST https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "bank_fee"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "category": "bank_fee"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "category": "bank_fee"
    },
)
data = response.json()

Pair a movement with one document, or split it across several. Also confirms a suggestion. Posts to the books, except kind hand_payment: the line takes over a payment typed by hand, which already did. When that line is for less, on another account or on another date (code hand_payment_other_date, the date of the statement coming first), resolution keep lets the payment stand, with the rest waiting and the money moved across analytics; resolution correct redoes the payment from the line

POST/v1/bank-movements/{id}/match

Pair a movement with one document, or split it across several. Also confirms a suggestion. Posts to the books, except kind hand_payment: the line takes over a payment typed by hand, which already did. When that line is for less, on another account or on another date (code hand_payment_other_date, the date of the statement coming first), resolution keep lets the payment stand, with the rest waiting and the money moved across analytics; resolution correct redoes the payment from the line

Nástroj MCP: match-bank-movement

Parametry v cestě

idstringpovinné

Tělo požadavku

allocationsobject[]povinné

documentIdstringpovinné

ID of the document.

amountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

documentAmountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

resolution"keep" | "correct"

notestringmax 2000 chars

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

POST/v1/bank-movements/{id}/match

curl -X POST https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/match \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "allocations": [
    {
      "kind": "invoice",
      "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/match', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "allocations": [
      {
        "kind": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/match",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "allocations": [
            {
                "kind": "invoice",
                "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

The rest of a payment typed by hand will not arrive: the payment shrinks to what statement lines confirmed, and the rest is open on the document again

POST/v1/bank-movements/{id}/release-rest

The rest of a payment typed by hand will not arrive: the payment shrinks to what statement lines confirmed, and the rest is open on the document again

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: release-hand-payment-rest

Parametry v cestě

idstringpovinné

Odpověď · 200

releasedintegerpovinné

confirmedCountintegerpovinné

POST/v1/bank-movements/{id}/release-rest

curl -X POST https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release-rest \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release-rest', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release-rest",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Undo the pairing of a movement, or one part of a split. Reverses the postings

POST/v1/bank-movements/{id}/unmatch

Undo the pairing of a movement, or one part of a split. Reverses the postings

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: unmatch-bank-movement

Parametry v cestě

idstringpovinné

Tělo požadavku

allocationIdstring

ID of the allocation.

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

statementIdnull | stringpovinné

sourcestringpovinné

externalIdnull | stringpovinné

bookedOnstringpovinnédate

valueDatestring | nullpovinné

amountHalerintegerpovinné

currencystringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

counterpartyNamenull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

bankTypenull | stringpovinné

isReversalbooleanpovinné

statusstringpovinné

allocatedHalerintegerpovinné

remainingHalerinteger | nullpovinné

createdAtstringpovinnédate-time

allocationsobject[]povinné

object"bank_allocation"povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

paymentIdnull | stringpovinné

amountHalerintegerpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

counterBankAccountIdnull | stringpovinné

exchangeRatenull | numberpovinné

orderItemIdnull | stringpovinné

confidencenull | numberpovinné

matchedBystringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

suggestionsobject[]povinné

typestringpovinné

kindstring

documentIdnull | string

numbernull | string

contactNamenull | string

orderItemIdnull | string

amountHalerintegerpovinné

remainingHalerinteger | null

confidencenull | numberpovinné

levelstringpovinné

reasonnull | stringpovinné

sourcestring

accountNumbernull | string

classificationstring | null

categorynull | string

counterBankAccountIdnull | string

ruleIdstring

ruleNamestring

POST/v1/bank-movements/{id}/unmatch

curl -X POST https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unmatch \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "allocationId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unmatch', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "allocationId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unmatch",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "allocationId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Run automatic pairing over all open movements. Only exact matches above the safe threshold are paired

POST/v1/bank-movements/auto-match

Run automatic pairing over all open movements. Only exact matches above the safe threshold are paired

Nástroj MCP: auto-match-bank-movements

Odpověď · 200

checkedCountintegerpovinné

matchedCountintegerpovinné

movementIdsstring[]povinné

POST/v1/bank-movements/auto-match

curl -X POST https://api.damedoklad.cz/v1/bank-movements/auto-match \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/bank-movements/auto-match', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-movements/auto-match",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Unpaid documents a movement can be paired with. direction=in lists issued invoices, proformas, debit notes, other receivables, and refunds of advances from suppliers; out lists received invoices, advances to suppliers, credit notes, other payables, payroll payments, and advances on business trips. Business trips follow their own side, and payments typed by hand (hand_payment) wait on either for the line that takes them over

GET/v1/bank-open-documents

Unpaid documents a movement can be paired with. direction=in lists issued invoices, proformas, debit notes, other receivables, and refunds of advances from suppliers; out lists received invoices, advances to suppliers, credit notes, other payables, payroll payments, and advances on business trips. Business trips follow their own side, and payments typed by hand (hand_payment) wait on either for the line that takes them over

Nástroj MCP: list-bank-open-documents

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

direction"in" | "out"

Odpověď · 200

dataobject[]povinné

object"open_document"povinné

kindstringpovinné

idstringpovinné

numbernull | stringpovinné

variableSymbolnull | stringpovinné

currencynull | stringpovinné

totalHalerinteger | nullpovinné

remainingHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

contactNamenull | stringpovinné

contactIdnull | stringpovinné

inPaymentbooleanpovinné

incomingboolean

bankAccountIdstring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-open-documents

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-open-documents', {
  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/bank-open-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Post every stated opening balance of bank accounts and cash registers that is not in the books yet. A sweep does this by itself every few hours, so this only says at once what a closed period still stops. Safe to repeat

POST/v1/bank-opening-balances/post

Post every stated opening balance of bank accounts and cash registers that is not in the books yet. A sweep does this by itself every few hours, so this only says at once what a closed period still stops. Safe to repeat. Legal effect: posts MD 221xxx or 211xxx / D 701, or sets the opening cash and bank of the peněžní deník. A balance the opening entries already hold posts nothing. notPosted lists what a closed period stopped.

Nástroj MCP: post-stated-opening-balances

Odpověď · 200

notPostedany[]povinné

POST/v1/bank-opening-balances/post

curl -X POST https://api.damedoklad.cz/v1/bank-opening-balances/post \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/bank-opening-balances/post', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

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

Totals for the bank page: movements waiting to be paired and how many of the newest have a confident suggestion

GET/v1/bank-overview

Totals for the bank page: movements waiting to be paired and how many of the newest have a confident suggestion

Nástroj MCP: get-bank-overview

Odpověď · 200

unmatchedCountintegerpovinné

unmatchedAbsHalerintegerpovinné

suggestedCountintegerpovinné

suggestedCountPartialbooleanpovinné

GET/v1/bank-overview

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-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/bank-overview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Unpaid received invoices, advances to suppliers, and other payables ready for a payment order, with a due date filter. `kind` tells them apart, inPayment marks those already on an order

GET/v1/bank-payable-invoices

Unpaid received invoices, advances to suppliers, and other payables ready for a payment order, with a due date filter. `kind` tells them apart, inPayment marks those already on an order

Nástroj MCP: list-payable-received-invoices

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

dueTostringYYYY-MM-DD

Date as YYYY-MM-DD.

dueFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

Odpověď · 200

dataobject[]povinné

object"payable_invoice"povinné

kindstringpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | string

contactNamenull | stringpovinné

variableSymbolnull | stringpovinné

dueDatenull | stringpovinnédate

currencynull | stringpovinné

totalHalerinteger | nullpovinné

remainingHalerinteger | nullpovinné

hasBankAccountbooleanpovinné

inPaymentbooleanpovinné

paymentOrderIdnull | stringpovinné

approvalBlockedbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-payable-invoices

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-payable-invoices', {
  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/bank-payable-invoices",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List pairing rules such as "ČEZ → 502". Rules only ever suggest, a person confirms

GET/v1/bank-rules

List pairing rules such as "ČEZ → 502". Rules only ever suggest, a person confirms

Nástroj MCP: list-bank-rules

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-rules

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-rules', {
  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/bank-rules",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a pairing rule: what to recognise on a movement, and how to book it

POST/v1/bank-rules

Create a pairing rule: what to recognise on a movement, and how to book it

Nástroj MCP: create-bank-rule

Tělo požadavku

namestringpovinnémax 200 chars

direction"any" | "in" | "out"

counterpartyNameContainsstringmax 200 chars

counterpartyAccountstring

counterpartyBankCodestring

messageContainsstringmax 200 chars

variableSymbolstring

accountNumberstring

Account number from the chart of accounts, for example 311. list-accounts lists them.

classification"income_taxable" | "income_nontax" | "expense_deductible" | "expense_nontax" | "transfer"

priorityintegermin 0max 1000

isActiveboolean

Odpověď · 201

idstringpovinné

namestringpovinné

directionstringpovinné

counterpartyNameContainsnull | stringpovinné

counterpartyAccountstring | nullpovinné

counterpartyBankCodestring | nullpovinné

messageContainsnull | stringpovinné

variableSymbolstring | nullpovinné

categorystringpovinné

accountNumbernull | stringpovinné

classificationstring | nullpovinné

priorityintegerpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

POST/v1/bank-rules

curl -X POST https://api.damedoklad.cz/v1/bank-rules \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "category": "bank_fee"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-rules', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "category": "bank_fee"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-rules",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "category": "bank_fee"
    },
)
data = response.json()

Update a pairing rule

PATCH/v1/bank-rules/{id}

Update a pairing rule

Nástroj MCP: update-bank-rule

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

direction"any" | "in" | "out"

counterpartyNameContainsstringmax 200 chars

counterpartyAccountstring

counterpartyBankCodestring

messageContainsstringmax 200 chars

variableSymbolstring

accountNumberstring

Account number from the chart of accounts, for example 311. list-accounts lists them.

classification"income_taxable" | "income_nontax" | "expense_deductible" | "expense_nontax" | "transfer"

priorityintegermin 0max 1000

isActiveboolean

Odpověď · 200

idstringpovinné

namestringpovinné

directionstringpovinné

counterpartyNameContainsnull | stringpovinné

counterpartyAccountstring | nullpovinné

counterpartyBankCodestring | nullpovinné

messageContainsnull | stringpovinné

variableSymbolstring | nullpovinné

categorystringpovinné

accountNumbernull | stringpovinné

classificationstring | nullpovinné

priorityintegerpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

PATCH/v1/bank-rules/{id}

curl -X PATCH https://api.damedoklad.cz/v1/bank-rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "direction": "any",
  "counterpartyNameContains": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "direction": "any",
    "counterpartyNameContains": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/bank-rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "direction": "any",
        "counterpartyNameContains": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Delete a pairing rule

DELETE/v1/bank-rules/{id}

Delete a pairing rule

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-bank-rule

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/bank-rules/{id}

curl -X DELETE https://api.damedoklad.cz/v1/bank-rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

List imported statements with opening and closing balances and the continuity check against the previous statement

GET/v1/bank-statements

List imported statements with opening and closing balances and the continuity check against the previous statement

Nástroj MCP: list-bank-statements

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

Odpověď · 200

dataobject[]povinné

object"bank_statement"povinné

idstringpovinné

bankAccountIdstringpovinné

formatstringpovinné

fileNamenull | stringpovinné

numbernull | stringpovinné

periodFromnull | stringpovinnédate

periodTonull | stringpovinnédate

openingBalanceHalerinteger | nullpovinné

closingBalanceHalerinteger | nullpovinné

debitTotalHalerintegerpovinné

creditTotalHalerintegerpovinné

movementCountintegerpovinné

importedCountintegerpovinné

duplicateCountintegerpovinné

autoMatchedCountintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

messagenull | stringpovinné

diffHalerintegerpovinné

createdAtstringpovinnédate-time

continuitystring

continuityDiffHalerinteger

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/bank-statements

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

const response = await fetch('https://api.damedoklad.cz/v1/bank-statements', {
  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/bank-statements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Import a statement file sent as base64: GPC/ABO, CAMT.053, MT940, or CSV with a column mapping. Re-importing never double-books

POST/v1/bank-statements/import

Import a statement file sent as base64: GPC/ABO, CAMT.053, MT940, or CSV with a column mapping. Re-importing never double-books. The format is detected unless given. A file already imported to the account returns duplicateFile: true. Movements already on the account are skipped by fingerprint, also across formats. Safe exact matches are paired automatically.

Nástroj MCP: import-bank-statement

Tělo požadavku

bankAccountIdstringpovinné

ID of the bank account. Find it with list-bank-accounts.

fileBase64stringpovinnémin 4 charsmax 20000000 chars

File content encoded as base64.

fileNamestringmax 200 chars

format"auto" | "gpc" | "camt053" | "mt940" | "csv"

encoding"windows-1250" | "utf-8" | "iso-8859-2"

gpcVariant"fio" | "cs"

csvobject

mappingobjectpovinné

bookedOnstring

Date as YYYY-MM-DD.

amountstring

creditstring

debitstring

currencystring

ISO 4217 currency code, for example CZK or EUR.

counterpartyAccountstring

counterpartyBankCodestring

counterpartyIbanstring

IBAN without spaces.

counterpartyNamestring

variableSymbolstring

constantSymbolstring

specificSymbolstring

messagestring

externalIdstring

ID of the external.

bankTypestring

delimiterstring1 chars

numberstringmax 40 chars

openingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

closingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 201

duplicateFilebooleanpovinné

importedCountintegerpovinné

duplicateCountintegerpovinné

autoMatchedCountintegerpovinné

statementsobject[]povinné

object"bank_statement"povinné

idstringpovinné

bankAccountIdstringpovinné

formatstringpovinné

fileNamenull | stringpovinné

numbernull | stringpovinné

periodFromnull | stringpovinnédate

periodTonull | stringpovinnédate

openingBalanceHalerinteger | nullpovinné

closingBalanceHalerinteger | nullpovinné

debitTotalHalerintegerpovinné

creditTotalHalerintegerpovinné

movementCountintegerpovinné

importedCountintegerpovinné

duplicateCountintegerpovinné

autoMatchedCountintegerpovinné

warningsobject[]povinné

codenull | stringpovinné

messagenull | stringpovinné

diffHalerintegerpovinné

createdAtstringpovinnédate-time

continuitystring

continuityDiffHalerinteger

POST/v1/bank-statements/import

curl -X POST https://api.damedoklad.cz/v1/bank-statements/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-statements/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-statements/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "fileBase64": "string"
    },
)
data = response.json()

Read the columns of a CSV file sent as base64 and suggest the mapping, without importing anything

POST/v1/bank-statements/inspect-csv

Read the columns of a CSV file sent as base64 and suggest the mapping, without importing anything

Nástroj MCP: inspect-bank-csv

Tělo požadavku

fileBase64stringpovinnémin 4 charsmax 20000000 chars

File content encoded as base64.

encoding"windows-1250" | "utf-8" | "iso-8859-2"

delimiterstring1 chars

Odpověď · 200

delimiterstringpovinné

headersstring[]povinné

sampleRowsstring[][]povinné

rowCountintegerpovinné

suggestedMappingobjectpovinné

bookedOnstringpovinné

amountstringpovinné

variableSymbolnull | stringpovinné

POST/v1/bank-statements/inspect-csv

curl -X POST https://api.damedoklad.cz/v1/bank-statements/inspect-csv \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bank-statements/inspect-csv', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bank-statements/inspect-csv",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string"
    },
)
data = response.json()

Imported settlements from card terminals and gateways, newest first. status=imported lists what still waits for its bank movement

GET/v1/card-settlements

Imported settlements from card terminals and gateways, newest first. status=imported lists what still waits for its bank movement

Nástroj MCP: list-card-settlements

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"imported" | "posted"

Odpověď · 200

dataobject[]povinné

object"card_settlement"povinné

idstringpovinné

providernull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

fileNamenull | stringpovinné

settledOnnull | stringpovinnédate

currencynull | stringpovinné

grossHalerintegerpovinné

refundHalerintegerpovinné

feeHalerintegerpovinné

otherHalerintegerpovinné

payoutHalerintegerpovinné

differenceHalerintegerpovinné

payoutReferencenull | stringpovinné

statusstringpovinné

clearingAccountnull | stringpovinné

feeAccountnull | stringpovinné

movementIdnull | stringpovinné

postedAtnull | stringpovinnédate-time

linesobject[]

referencenull | stringpovinné

amountHalerintegerpovinné

variableSymbolnull | stringpovinné

occurredOnnull | stringpovinnédate

descriptionnull | stringpovinné

kindstringpovinné

positionintegerpovinné

feeHalerintegerpovinné

object"card_settlement_line"povinné

idstring

documentKindnull | string

documentIdnull | string

paymentIdnull | string

movementCandidatesobject[]

idstringpovinné

bookedOnstringpovinnédate

amountHalerinteger | nullpovinné

variableSymbolnull | stringpovinné

counterpartyNamenull | stringpovinné

symbolMatchesbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/card-settlements

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

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements', {
  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/card-settlements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

One settlement with its lines and the bank movements that could have paid it out

GET/v1/card-settlements/{id}

One settlement with its lines and the bank movements that could have paid it out

Nástroj MCP: get-card-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

providernull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

fileNamenull | stringpovinné

settledOnnull | stringpovinnédate

currencynull | stringpovinné

grossHalerintegerpovinné

refundHalerintegerpovinné

feeHalerintegerpovinné

otherHalerintegerpovinné

payoutHalerintegerpovinné

differenceHalerintegerpovinné

payoutReferencenull | stringpovinné

statusstringpovinné

clearingAccountnull | stringpovinné

feeAccountnull | stringpovinné

movementIdnull | stringpovinné

postedAtnull | stringpovinnédate-time

linesobject[]

referencenull | stringpovinné

amountHalerintegerpovinné

variableSymbolnull | stringpovinné

occurredOnnull | stringpovinnédate

descriptionnull | stringpovinné

kindstringpovinné

positionintegerpovinné

feeHalerintegerpovinné

object"card_settlement_line"povinné

idstring

documentKindnull | string

documentIdnull | string

paymentIdnull | string

movementCandidatesobject[]

idstringpovinné

bookedOnstringpovinnédate

amountHalerinteger | nullpovinné

variableSymbolnull | stringpovinné

counterpartyNamenull | stringpovinné

symbolMatchesbooleanpovinné

GET/v1/card-settlements/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Remove an imported settlement that has not been posted

DELETE/v1/card-settlements/{id}

Remove an imported settlement that has not been posted

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-card-settlement

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/card-settlements/{id}

curl -X DELETE https://api.damedoklad.cz/v1/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Pair a settlement with the bank movement of its payout and post it: the payout and the fee clear the clearing account. Pays open invoices named by symbol

POST/v1/card-settlements/{id}/post

Pair a settlement with the bank movement of its payout and post it: the payout and the fee clear the clearing account. Pays open invoices named by symbol. Refused if the file does not add up or the movement is for another amount. Unpairing the movement in Banka reverses all of it.

Nástroj MCP: post-card-settlement

Parametry v cestě

idstringpovinné

Tělo požadavku

movementIdstringpovinné

ID of the movement. Find it with list-movements.

clearingAccountstring

feeAccountstring

Odpověď · 200

idstringpovinné

providernull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

fileNamenull | stringpovinné

settledOnnull | stringpovinnédate

currencynull | stringpovinné

grossHalerintegerpovinné

refundHalerintegerpovinné

feeHalerintegerpovinné

otherHalerintegerpovinné

payoutHalerintegerpovinné

differenceHalerintegerpovinné

payoutReferencenull | stringpovinné

statusstringpovinné

clearingAccountnull | stringpovinné

feeAccountnull | stringpovinné

movementIdnull | stringpovinné

postedAtnull | stringpovinnédate-time

linesobject[]

referencenull | stringpovinné

amountHalerintegerpovinné

variableSymbolnull | stringpovinné

occurredOnnull | stringpovinnédate

descriptionnull | stringpovinné

kindstringpovinné

positionintegerpovinné

feeHalerintegerpovinné

object"card_settlement_line"povinné

idstring

documentKindnull | string

documentIdnull | string

paymentIdnull | string

movementCandidatesobject[]

idstringpovinné

bookedOnstringpovinnédate

amountHalerinteger | nullpovinné

variableSymbolnull | stringpovinné

counterpartyNamenull | stringpovinné

symbolMatchesbooleanpovinné

POST/v1/card-settlements/{id}/post

curl -X POST https://api.damedoklad.cz/v1/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/card-settlements/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Read a settlement file from a card terminal or gateway sent as base64. dryRun shows the result without saving. Importing the same file again changes nothing

POST/v1/card-settlements/import

Read a settlement file from a card terminal or gateway sent as base64. dryRun shows the result without saving. Importing the same file again changes nothing. Only ComGate publishes what its rows mean. For GoPay, ThePay, KB SmartPay and PayU the rows are read by a rule of thumb, so saving needs confirmUnverified: true after a person checked the preview. PayU needs columns. Nothing is posted until postCardSettlement.

Nástroj MCP: import-card-settlement

Tělo požadavku

provider"comgate" | "gopay" | "thepay" | "kb_smartpay" | "payu"povinné

fileBase64stringpovinnémin 4 charsmax 20000000 chars

File content encoded as base64.

fileNamestringmax 200 chars

encoding"windows-1250" | "utf-8" | "iso-8859-2"

settledOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

columnsobject

grossstringpovinnémax 120 chars

feestringmax 120 chars

netstringmax 120 chars

datestringmax 120 chars

Date as YYYY-MM-DD.

variableSymbolstringmax 120 chars

referencestringmax 120 chars

batchstringmax 120 chars

dryRunboolean

confirmUnverifiedboolean

Odpověď · 201

providernull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

settledOnnull | stringpovinnédate

currencynull | stringpovinné

grossHalerintegerpovinné

refundHalerintegerpovinné

feeHalerintegerpovinné

otherHalerintegerpovinné

payoutHalerintegerpovinné

differenceHalerintegerpovinné

payoutReferencenull | stringpovinné

warningsstring[]povinné

linesobject[]

referencenull | stringpovinné

amountHalerintegerpovinné

variableSymbolnull | stringpovinné

occurredOnnull | stringpovinnédate

descriptionnull | stringpovinné

kindstringpovinné

positionintegerpovinné

feeHalerintegerpovinné

object"card_settlement_line"povinné

idstring

documentKindnull | string

documentIdnull | string

paymentIdnull | string

idstring

fileNamenull | string

statusstring

clearingAccountstring | null

feeAccountstring | null

movementIdstring | null

postedAtstring | null

duplicateFileboolean

POST/v1/card-settlements/import

curl -X POST https://api.damedoklad.cz/v1/card-settlements/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "provider": "comgate",
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "provider": "comgate",
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/card-settlements/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "provider": "comgate",
        "fileBase64": "string"
    },
)
data = response.json()

The clearing and fee accounts for card settlements, and which provider formats are published and which are unverified

GET/v1/card-settlements/settings

The clearing and fee accounts for card settlements, and which provider formats are published and which are unverified

Nástroj MCP: get-card-settlement-settings

Odpověď · 200

clearingAccountnull | stringpovinné

feeAccountnull | stringpovinné

providersobject[]povinné

idstringpovinné

labelnull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

GET/v1/card-settlements/settings

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

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements/settings', {
  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/card-settlements/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the clearing account card sales wait on, and the account for fees. Applies to card sales from now on

PATCH/v1/card-settlements/settings

Set the clearing account card sales wait on, and the account for fees. Applies to card sales from now on. The clearing account must exist in the chart. Default is 261; an analytic such as 261100 keeps card money apart from cash on its way to the bank.

Nástroj MCP: update-card-settlement-settings

Tělo požadavku

clearingAccountstring

feeAccountstring

Odpověď · 200

clearingAccountnull | stringpovinné

feeAccountnull | stringpovinné

providersobject[]povinné

idstringpovinné

labelnull | stringpovinné

formatstringpovinné

formatStatusstringpovinné

PATCH/v1/card-settlements/settings

curl -X PATCH https://api.damedoklad.cz/v1/card-settlements/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "clearingAccount": "string",
  "feeAccount": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/card-settlements/settings', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "clearingAccount": "string",
    "feeAccount": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/card-settlements/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "clearingAccount": "string",
        "feeAccount": "string"
    },
)
data = response.json()

List cash documents, newest first. With registerId each row carries the running balance

GET/v1/cash-documents

List cash documents, newest first. With registerId each row carries the running balance

Nástroj MCP: list-cash-documents

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

registerIdstring

ID of the register.

kind"receipt" | "expense"

Odpověď · 200

dataobject[]povinné

object"cash_document"povinné

idstringpovinné

registerIdstringpovinné

kindstringpovinné

numberstringpovinné

issuedOnstringpovinnédate

amountHalerintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

vatRateintegerpovinné

exchangeRatenull | numberpovinné

counterpartyNamenull | stringpovinné

contactIdnull | stringpovinné

descriptionstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

negativeOverridebooleanpovinné

statusstringpovinné

createdAtstringpovinnédate-time

balanceHalerinteger | null

eetPrepaidLoadHalerinteger

eetPrepaidUseHalerinteger

eetVoucherIdnull | string

eetMandateIdstring | null

paidAtnull | stringdate-time

registerBalanceHalerinteger

warningsobject[]

codenull | stringpovinné

limitHalerintegerpovinné

totalHalerinteger | nullpovinné

messagenull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/cash-documents

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

const response = await fetch('https://api.damedoklad.cz/v1/cash-documents', {
  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/cash-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Issue a receipt or expense cash document and post it. Refuses a negative register balance unless allowNegative is true, and warns over the 270 000 Kč cash limit

POST/v1/cash-documents

Issue a receipt or expense cash document and post it. Refuses a negative register balance unless allowNegative is true, and warns over the 270 000 Kč cash limit

Nástroj MCP: create-cash-document

Tělo požadavku

registerIdstringpovinné

ID of the register.

kind"receipt" | "expense"povinné

issuedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

amountHalerintegerpovinnémax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

descriptionstringpovinnémax 400 chars

counterpartyNamestringmax 200 chars

contactIdstring

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

documentIdstring

ID of the document.

documentAmountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

accountNumberstring

Account number from the chart of accounts, for example 311. list-accounts lists them.

classification"income_taxable" | "income_nontax" | "expense_deductible" | "expense_nontax" | "transfer"

vatRatenumbermin 0max 100

vatCountrystring2 chars

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

purchaseLineIdstring

ID of the purchase line.

exchangeRatenumbermax 100000

allowNegativeboolean

eetPrepaidLoadHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

eetPrepaidUseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

eetVoucherIdstring

ID of the eet voucher. Find it with list-eet-vouchers.

eetMandateIdstring

ID of the eet mandate. Find it with list-eet-mandates.

eetOwnSaleboolean

paidAtstringdate-time

Odpověď · 201

idstringpovinné

registerIdstringpovinné

kindstringpovinné

numberstringpovinné

issuedOnstringpovinnédate

amountHalerintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

vatRateintegerpovinné

exchangeRatenull | numberpovinné

counterpartyNamenull | stringpovinné

contactIdnull | stringpovinné

descriptionstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

negativeOverridebooleanpovinné

statusstringpovinné

createdAtstringpovinnédate-time

balanceHalerinteger | null

eetPrepaidLoadHalerinteger

eetPrepaidUseHalerinteger

eetVoucherIdnull | string

eetMandateIdstring | null

paidAtnull | stringdate-time

registerBalanceHalerinteger

warningsobject[]

codenull | stringpovinné

limitHalerintegerpovinné

totalHalerinteger | nullpovinné

messagenull | stringpovinné

POST/v1/cash-documents

curl -X POST https://api.damedoklad.cz/v1/cash-documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "registerId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "kind": "receipt",
  "issuedOn": "2026-10-30",
  "amountHaler": 1210000,
  "description": "Pečivo, říjen"
}'

const response = await fetch('https://api.damedoklad.cz/v1/cash-documents', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "registerId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "kind": "receipt",
    "issuedOn": "2026-10-30",
    "amountHaler": 1210000,
    "description": "Pečivo, říjen"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/cash-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "registerId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "kind": "receipt",
        "issuedOn": "2026-10-30",
        "amountHaler": 1210000,
        "description": "Pečivo, říjen"
    },
)
data = response.json()

Get one cash document

GET/v1/cash-documents/{id}

Get one cash document

Nástroj MCP: get-cash-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

registerIdstringpovinné

kindstringpovinné

numberstringpovinné

issuedOnstringpovinnédate

amountHalerintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

vatRateintegerpovinné

exchangeRatenull | numberpovinné

counterpartyNamenull | stringpovinné

contactIdnull | stringpovinné

descriptionstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

negativeOverridebooleanpovinné

statusstringpovinné

createdAtstringpovinnédate-time

balanceHalerinteger | null

eetPrepaidLoadHalerinteger

eetPrepaidUseHalerinteger

eetVoucherIdnull | string

eetMandateIdstring | null

paidAtnull | stringdate-time

registerBalanceHalerinteger

warningsobject[]

codenull | stringpovinné

limitHalerintegerpovinné

totalHalerinteger | nullpovinné

messagenull | stringpovinné

GET/v1/cash-documents/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Cancel a cash document: the number stays used and the postings are reversed

POST/v1/cash-documents/{id}/cancel

Cancel a cash document: the number stays used and the postings are reversed

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: cancel-cash-document

Parametry v cestě

idstringpovinné

Tělo požadavku

allowNegativeboolean

Odpověď · 200

idstringpovinné

registerIdstringpovinné

kindstringpovinné

numberstringpovinné

issuedOnstringpovinnédate

amountHalerintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

vatRateintegerpovinné

exchangeRatenull | numberpovinné

counterpartyNamenull | stringpovinné

contactIdnull | stringpovinné

descriptionstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

categorynull | stringpovinné

accountNumbernull | stringpovinné

classificationnull | stringpovinné

negativeOverridebooleanpovinné

statusstringpovinné

createdAtstringpovinnédate-time

balanceHalerinteger | null

eetPrepaidLoadHalerinteger

eetPrepaidUseHalerinteger

eetVoucherIdnull | string

eetMandateIdstring | null

paidAtnull | stringdate-time

registerBalanceHalerinteger

warningsobject[]

codenull | stringpovinné

limitHalerintegerpovinné

totalHalerinteger | nullpovinné

messagenull | stringpovinné

POST/v1/cash-documents/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "allowNegative": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "allowNegative": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "allowNegative": False
    },
)
data = response.json()

Download a cash document as PDF

GET/v1/cash-documents/{id}/pdf

Download a cash document as PDF

Nástroj MCP: get-cash-document-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/cash-documents/{id}/pdf

curl https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  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/cash-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List cash registers with current balance

GET/v1/cash-registers

List cash registers with current balance

Nástroj MCP: list-cash-registers

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

Odpověď · 200

dataobject[]povinné

object"cash_register"povinné

idstringpovinné

namestringpovinné

currencystringpovinné

ledgerAccountstringpovinné

openingBalanceHalerintegerpovinné

openingDatenull | stringpovinnédate

openingExchangeRatenull | numberpovinné

openingStatestringpovinné

receiptPrefixstringpovinné

expensePrefixstringpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

balanceHalerintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/cash-registers

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

const response = await fetch('https://api.damedoklad.cz/v1/cash-registers', {
  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/cash-registers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a cash register. The analytic 211xxx account is filled in when omitted. A stated opening balance posts MD 211xxx / D 701, or the opening cash of the peněžní deník, unless opening entries already hold the account

POST/v1/cash-registers

Create a cash register. The analytic 211xxx account is filled in when omitted. A stated opening balance posts MD 211xxx / D 701, or the opening cash of the peněžní deník, unless opening entries already hold the account

Nástroj MCP: create-cash-register

Tělo požadavku

namestringpovinnémax 200 chars

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

ledgerAccountstring

openingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

openingDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

openingExchangeRatenumbermax 100000

receiptPrefixstring

expensePrefixstring

Odpověď · 201

idstringpovinné

namestringpovinné

currencystringpovinné

ledgerAccountstringpovinné

openingBalanceHalerintegerpovinné

openingDatenull | stringpovinnédate

openingExchangeRatenull | numberpovinné

openingStatestringpovinné

receiptPrefixstringpovinné

expensePrefixstringpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

balanceHalerintegerpovinné

POST/v1/cash-registers

curl -X POST https://api.damedoklad.cz/v1/cash-registers \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/cash-registers', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/cash-registers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Get one cash register

GET/v1/cash-registers/{id}

Get one cash register

Nástroj MCP: get-cash-register

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namestringpovinné

currencystringpovinné

ledgerAccountstringpovinné

openingBalanceHalerintegerpovinné

openingDatenull | stringpovinnédate

openingExchangeRatenull | numberpovinné

openingStatestringpovinné

receiptPrefixstringpovinné

expensePrefixstringpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

balanceHalerintegerpovinné

GET/v1/cash-registers/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Update a cash register. Currency, analytic account, and opening balance are locked once it has documents

PATCH/v1/cash-registers/{id}

Update a cash register. Currency, analytic account, and opening balance are locked once it has documents

Nástroj MCP: update-cash-register

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

ledgerAccountstring

openingBalanceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

openingDatestring | null

Date as YYYY-MM-DD.

openingExchangeRatenumbermax 100000

receiptPrefixstring

expensePrefixstring

isActiveboolean

Odpověď · 200

idstringpovinné

namestringpovinné

currencystringpovinné

ledgerAccountstringpovinné

openingBalanceHalerintegerpovinné

openingDatenull | stringpovinnédate

openingExchangeRatenull | numberpovinné

openingStatestringpovinné

receiptPrefixstringpovinné

expensePrefixstringpovinné

isActivebooleanpovinné

createdAtstringpovinnédate-time

balanceHalerintegerpovinné

PATCH/v1/cash-registers/{id}

curl -X PATCH https://api.damedoklad.cz/v1/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Hlavní pokladna",
  "ledgerAccount": "211001"
}'

const response = await fetch('https://api.damedoklad.cz/v1/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Hlavní pokladna",
    "ledgerAccount": "211001"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Hlavní pokladna",
        "ledgerAccount": "211001"
    },
)
data = response.json()

Delete a cash register that has no documents. Its posted opening balance is reversed

DELETE/v1/cash-registers/{id}

Delete a cash register that has no documents. Its posted opening balance is reversed

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-cash-register

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/cash-registers/{id}

curl -X DELETE https://api.damedoklad.cz/v1/cash-registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

List payment orders

GET/v1/payment-orders

List payment orders

Nástroj MCP: list-payment-orders

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"draft" | "exported" | "completed" | "cancelled"

kind"payment" | "collection"

Odpověď · 200

dataobject[]povinné

object"payment_order"povinné

idstringpovinné

bankAccountIdstringpovinné

numberintegerpovinné

executionDatestringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

statusstringpovinné

exportedFormatnull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

itemsobject[]povinné

object"payment_order_item"povinné

idstringpovinné

orderIdstringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

otherPayableIdnull | stringpovinné

payrollPaymentIdnull | stringpovinné

amountHalerintegerpovinné

counterpartyNamenull | stringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

statusstringpovinné

movementIdnull | stringpovinné

salesDocumentIdnull | string

invoiceIdnull | string

mandateIdnull | string

sequenceTypenull | string

counterpartyBicnull | string

counterpartyCountrynull | string

chargeBearernull | string

paymentReasonnull | string

kindstring

schemestring

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamenull | stringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/payment-orders

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

const response = await fetch('https://api.damedoklad.cz/v1/payment-orders', {
  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/payment-orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a payment order from unpaid received invoices, advances to suppliers, and other payables, or with kind collection a příkaz k inkasu from issued invoices, debit notes, and other receivables. scheme foreign pays abroad in the document's currency from any account. They are marked as in payment and pair when the movement arrives. The answer lists supplier warnings (§ 109), which never block

POST/v1/payment-orders

Create a payment order from unpaid received invoices, advances to suppliers, and other payables, or with kind collection a příkaz k inkasu from issued invoices, debit notes, and other receivables. scheme foreign pays abroad in the document's currency from any account. They are marked as in payment and pair when the movement arrives. The answer lists supplier warnings (§ 109), which never block

Nástroj MCP: create-payment-order

Tělo požadavku

bankAccountIdstringpovinné

ID of the bank account. Find it with list-bank-accounts.

executionDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

kind"payment" | "collection"

collection is a příkaz k inkasu: money the bank pulls from customers. Default payment

scheme"domestic" | "sepa" | "foreign"

foreign lets the order be in another currency than the account. Default follows the account: CZK domestic, EUR SEPA, others foreign

itemsobject[]povinné

receivedInvoiceIdstring

ID of the received invoice. Find it with list-received-invoices.

supplierAdvanceIdstring

ID of the supplier advance. Find it with list-supplier-advances.

otherPayableIdstring

ID of the other payable.

invoiceIdstring

ID of the invoice. Find it with list-invoices.

debitNoteIdstring

ID of the debit note.

otherReceivableIdstring

ID of the other receivable.

mandateIdstring

For a SEPA collection. Without it the only active mandate of the contact is used

amountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

messagestringmax 140 chars

foreignobject

accountstringmax 34 chars

IBAN, or the account number where the country has no IBAN

bicstring

streetstringmax 70 chars

citystringmax 35 chars

countrystring

bankNamestringmax 70 chars

bankStreetstringmax 70 chars

bankCitystringmax 35 chars

chargeBearer"SHA" | "OUR" | "BEN"

Who bears the charges. Default SHA, the only one allowed within the EU/EEA

paymentReasonstring

Payment title from the ČNB list, which some banks ask for

Odpověď · 201

idstringpovinné

bankAccountIdstringpovinné

numberintegerpovinné

executionDatestringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

statusstringpovinné

exportedFormatnull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

itemsobject[]povinné

object"payment_order_item"povinné

idstringpovinné

orderIdstringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

otherPayableIdnull | stringpovinné

payrollPaymentIdnull | stringpovinné

amountHalerintegerpovinné

counterpartyNamenull | stringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

statusstringpovinné

movementIdnull | stringpovinné

salesDocumentIdnull | string

invoiceIdnull | string

mandateIdnull | string

sequenceTypenull | string

counterpartyBicnull | string

counterpartyCountrynull | string

chargeBearernull | string

paymentReasonnull | string

kindstring

schemestring

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamenull | stringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

POST/v1/payment-orders

curl -X POST https://api.damedoklad.cz/v1/payment-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "executionDate": "2026-10-30",
  "items": [
    {
      "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payment-orders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "executionDate": "2026-10-30",
    "items": [
      {
        "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payment-orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bankAccountId": "cba_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "executionDate": "2026-10-30",
        "items": [
            {
                "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Get a payment order with its items

GET/v1/payment-orders/{id}

Get a payment order with its items

Nástroj MCP: get-payment-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

numberintegerpovinné

executionDatestringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

statusstringpovinné

exportedFormatnull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

itemsobject[]povinné

object"payment_order_item"povinné

idstringpovinné

orderIdstringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

otherPayableIdnull | stringpovinné

payrollPaymentIdnull | stringpovinné

amountHalerintegerpovinné

counterpartyNamenull | stringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

statusstringpovinné

movementIdnull | stringpovinné

salesDocumentIdnull | string

invoiceIdnull | string

mandateIdnull | string

sequenceTypenull | string

counterpartyBicnull | string

counterpartyCountrynull | string

chargeBearernull | string

paymentReasonnull | string

kindstring

schemestring

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamenull | stringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

GET/v1/payment-orders/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/payment-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/payment-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Cancel a payment order and release its invoices. An order with a paid item cannot be cancelled

POST/v1/payment-orders/{id}/cancel

Cancel a payment order and release its invoices. An order with a paid item cannot be cancelled

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: cancel-payment-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

bankAccountIdstringpovinné

numberintegerpovinné

executionDatestringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

statusstringpovinné

exportedFormatnull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

itemsobject[]povinné

object"payment_order_item"povinné

idstringpovinné

orderIdstringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

otherPayableIdnull | stringpovinné

payrollPaymentIdnull | stringpovinné

amountHalerintegerpovinné

counterpartyNamenull | stringpovinné

counterpartyAccountnull | stringpovinné

counterpartyBankCodenull | stringpovinné

counterpartyIbannull | stringpovinné

variableSymbolnull | stringpovinné

constantSymbolnull | stringpovinné

specificSymbolstring | nullpovinné

messagenull | stringpovinné

statusstringpovinné

movementIdnull | stringpovinné

salesDocumentIdnull | string

invoiceIdnull | string

mandateIdnull | string

sequenceTypenull | string

counterpartyBicnull | string

counterpartyCountrynull | string

chargeBearernull | string

paymentReasonnull | string

kindstring

schemestring

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamenull | stringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

POST/v1/payment-orders/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/payment-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Download an order for the bank. kpc: domestic KPC/ABO in CZK, also a příkaz k inkasu. xml: domestic pain.001, or pain.008 for a collection, as the Czech Banking Association describes. sepa: pain.001 in EUR. foreign: pain.001 for a foreign payment. direct_debit: pain.008 SEPA in EUR

GET/v1/payment-orders/{id}/export

Download an order for the bank. kpc: domestic KPC/ABO in CZK, also a příkaz k inkasu. xml: domestic pain.001, or pain.008 for a collection, as the Czech Banking Association describes. sepa: pain.001 in EUR. foreign: pain.001 for a foreign payment. direct_debit: pain.008 SEPA in EUR

Nástroj MCP: export-payment-order

Parametry v cestě

idstringpovinné

Parametry dotazu

format"kpc" | "sepa" | "xml" | "foreign" | "direct_debit"

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/payment-orders/{id}/export

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

const response = await fetch('https://api.damedoklad.cz/v1/payment-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/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/payment-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Before paying: warn about unreliable VAT payers and bank accounts not published in the ADIS register, with the § 109 liability they bring. Warns and never blocks. A registry that cannot be reached is reported, not an error

POST/v1/payment-orders/check

Before paying: warn about unreliable VAT payers and bank accounts not published in the ADIS register, with the § 109 liability they bring. Warns and never blocks. A registry that cannot be reached is reported, not an error

Nástroj MCP: check-payment-order

Tělo požadavku

itemsobject[]povinné

receivedInvoiceIdstring

ID of the received invoice. Find it with list-received-invoices.

supplierAdvanceIdstring

ID of the supplier advance. Find it with list-supplier-advances.

otherPayableIdstring

ID of the other payable.

Odpověď · 200

dataobject[]povinné

receivedInvoiceIdnull | stringpovinné

numbernull | stringpovinné

contactNamenull | stringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

POST/v1/payment-orders/check

curl -X POST https://api.damedoklad.cz/v1/payment-orders/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/payment-orders/check', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "items": [
      {
        "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/payment-orders/check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "items": [
            {
                "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "supplierAdvanceId": "sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "otherPayableId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Customers' SEPA mandates, which a SEPA direct debit draws on

GET/v1/sepa-mandates

Customers' SEPA mandates, which a SEPA direct debit draws on

Nástroj MCP: list-sepa-mandates

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

contactIdstring

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

status"active" | "revoked"

Odpověď · 200

dataobject[]povinné

object"sepa_mandate"povinné

idstringpovinné

contactIdstringpovinné

referencestringpovinné

signedOnstringpovinnédate

schemestringpovinné

recurrencestringpovinné

debtorIbanstringpovinné

debtorBicnull | stringpovinné

statusstringpovinné

createdAtstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sepa-mandates

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

const response = await fetch('https://api.damedoklad.cz/v1/sepa-mandates', {
  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/sepa-mandates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record a customer's signed SEPA mandate. The paper stays with the company, and the bank asks only for its identifier and date

POST/v1/sepa-mandates

Record a customer's signed SEPA mandate. The paper stays with the company, and the bank asks only for its identifier and date

Nástroj MCP: create-sepa-mandate

Tělo požadavku

contactIdstringpovinné

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

referencestringpovinnémax 35 chars

Identifier of the mandate, as the customer signed it

signedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

scheme"CORE" | "B2B"

CORE for consumers and anyone else, B2B between businesses. Default CORE

recurrence"recurring" | "one_off"

debtorIbanstringpovinnémin 5 charsmax 42 chars

IBAN without spaces.

debtorBicstring

Odpověď · 201

idstringpovinné

contactIdstringpovinné

referencestringpovinné

signedOnstringpovinnédate

schemestringpovinné

recurrencestringpovinné

debtorIbanstringpovinné

debtorBicnull | stringpovinné

statusstringpovinné

createdAtstringpovinnédate-time

POST/v1/sepa-mandates

curl -X POST https://api.damedoklad.cz/v1/sepa-mandates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "reference": "string",
  "signedOn": "2026-10-30",
  "debtorIban": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sepa-mandates', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "reference": "string",
    "signedOn": "2026-10-30",
    "debtorIban": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sepa-mandates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "reference": "string",
        "signedOn": "2026-10-30",
        "debtorIban": "string"
    },
)
data = response.json()

Revoke a SEPA mandate with status revoked, which stops any order that has not left yet, or correct its BIC. Another account or other terms are a new mandate

PATCH/v1/sepa-mandates/{id}

Revoke a SEPA mandate with status revoked, which stops any order that has not left yet, or correct its BIC. Another account or other terms are a new mandate

Nástroj MCP: update-sepa-mandate

Parametry v cestě

idstringpovinné

Tělo požadavku

debtorBicstring | null

status"active" | "revoked"

Odpověď · 200

idstringpovinné

contactIdstringpovinné

referencestringpovinné

signedOnstringpovinnédate

schemestringpovinné

recurrencestringpovinné

debtorIbanstringpovinné

debtorBicnull | stringpovinné

statusstringpovinné

createdAtstringpovinnédate-time

PATCH/v1/sepa-mandates/{id}

curl -X PATCH https://api.damedoklad.cz/v1/sepa-mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "debtorBic": "string",
  "status": "active"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sepa-mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "debtorBic": "string",
    "status": "active"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/sepa-mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "debtorBic": "string",
        "status": "active"
    },
)
data = response.json()

Build a Czech QR payment string (SPAYD) from payment details

POST/v1/spayd

Build a Czech QR payment string (SPAYD) from payment details

Nástroj MCP: create-spayd

Tělo požadavku

ibanstringpovinnémax 42 chars

IBAN without spaces.

bicstring

amountHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

variableSymbolstring

specificSymbolstring

constantSymbolstring

recipientNamestringmax 200 chars

messagestringmax 400 chars

dueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

spaydstringpovinné

POST/v1/spayd

curl -X POST https://api.damedoklad.cz/v1/spayd \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "iban": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/spayd', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "iban": "string"
  }),
});
const data = await response.json();

import os
import requests

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