Platforma

Operace ve skupině Platforma.

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

GET/v1/access-roles
POST/v1/access-roles
GET/v1/access-roles/{id}
PATCH/v1/access-roles/{id}
DEL/v1/access-roles/{id}
GET/v1/access-roles/{id}/effective
GET/v1/access-roles/catalog
GET/v1/activity
GET/v1/api-keys
POST/v1/api-keys
DEL/v1/api-keys/{id}
GET/v1/audit-events
GET/v1/audit/chain
GET/v1/audit/entries
GET/v1/audit/entries.csv
GET/v1/audit/entries.xlsx
GET/v1/audit/entries/{id}
GET/v1/audit/facets
GET/v1/audit/objects/{id}/history
POST/v1/audit/verify
GET/v1/billing
GET/v1/company
PATCH/v1/company
GET/v1/company/agendas
PUT/v1/company/agendas
POST/v1/company/ares
GET/v1/company/logo
POST/v1/company/logo
POST/v1/company/regime
POST/v1/company/stamp
DEL/v1/company/stamp
GET/v1/document-comments
POST/v1/document-comments
DEL/v1/document-comments/{id}
POST/v1/document-comments/{id}/resolve
GET/v1/document-exports
GET/v1/document-requests
POST/v1/document-requests
POST/v1/document-requests/{id}/cancel
POST/v1/document-requests/{id}/fulfil
GET/v1/exports
POST/v1/exports
GET/v1/exports/{id}
GET/v1/exports/{id}/download
GET/v1/imports
POST/v1/imports
GET/v1/imports/{id}
POST/v1/imports/{id}/apply
GET/v1/imports/{id}/reconciliation
GET/v1/imports/{id}/undo
POST/v1/imports/{id}/undo
GET/v1/imports/documents
POST/v1/imports/mid-year
POST/v1/imports/opening-balances
GET/v1/inbox/address
POST/v1/inbox/address/rotate
GET/v1/inbox/documents
POST/v1/inbox/documents
GET/v1/inbox/documents/{id}
PATCH/v1/inbox/documents/{id}
POST/v1/inbox/documents/{id}/discard
POST/v1/inbox/documents/{id}/extract
GET/v1/inbox/documents/{id}/file
POST/v1/inbox/documents/{id}/received-invoice
POST/v1/inbox/documents/{id}/supplier-advance
GET/v1/inbox/email-settings
PUT/v1/inbox/email-settings
GET/v1/inbox/emails
GET/v1/inbox/summary
GET/v1/inbox/todo
GET/v1/invitations
DEL/v1/invitations/{id}
POST/v1/invitations/{id}/resend
GET/v1/mailboxes
POST/v1/mailboxes
PATCH/v1/mailboxes/{id}
DEL/v1/mailboxes/{id}
GET/v1/mailboxes/{id}/folders
POST/v1/mailboxes/{id}/sync
POST/v1/mailboxes/detect
GET/v1/mailboxes/messages
POST/v1/mailboxes/messages
GET/v1/mailboxes/messages/{id}
PATCH/v1/mailboxes/messages/{id}
DEL/v1/mailboxes/messages/{id}
POST/v1/mailboxes/messages/{id}/forward
POST/v1/mailboxes/messages/{id}/reply
GET/v1/mailboxes/providers
GET/v1/members
POST/v1/members
PATCH/v1/members/{id}
DEL/v1/members/{id}
GET/v1/members/{id}/access
GET/v1/members/me
GET/v1/notifications
GET/v1/search
POST/v1/webhook-deliveries/{id}/retry
GET/v1/webhook-events
GET/v1/webhooks
POST/v1/webhooks
GET/v1/webhooks/{id}
PATCH/v1/webhooks/{id}
DEL/v1/webhooks/{id}
GET/v1/webhooks/{id}/deliveries
POST/v1/webhooks/{id}/rotate-secret
POST/v1/webhooks/{id}/test

List the custom roles of this company and how many people have each

GET/v1/access-roles

List the custom roles of this company and how many people have each

Nástroj MCP: list-access-roles

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"access_role"povinné

idstringpovinné

namestringpovinné

descriptionstring | nullpovinné

agendasobjectpovinné

salesstring

payrollstring

administrationstring

bankstring

cashstring

reportsstring

contactsstring

inventorystring

inboxstring

purchasesstring

assetsstring

travelstring

taxstring

agendasstring

ledgerstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

memberCountintegerpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

parentIdnull | string

deniedobject

formatsstring[]povinné

reportsstring[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/access-roles

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

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

Create a custom role: a level per agenda (none, read, own, write, full), and optionally only chosen warehouses, cash registers, bank accounts, number series, and cost centres, without some print reports or export types, or as a sub-role of another

POST/v1/access-roles

Create a custom role: a level per agenda (none, read, own, write, full), and optionally only chosen warehouses, cash registers, bank accounts, number series, and cost centres, without some print reports or export types, or as a sub-role of another. own: reads everything, creates, and changes only what the person created. Delete and storno need full. A sub-role takes its parent's rights and can only take away. Members, API keys of others, webhooks, the audit log, and company-wide exports and imports stay with an owner or accountant whatever a custom role says.

Nástroj MCP: create-access-role

Tělo požadavku

namestringpovinnémax 120 chars

descriptionstring | null

agendasobjectpovinné

scopesobject

warehousesstring[] | null

registersstring[] | null

accountsstring[] | null

seriesstring[] | null

centersstring[] | null

parentIdstring | null

ID of the parent.

deniedobject

formats"pdf" | "xlsx" | "csv" | "xml" | "zip"[]

reportsstring[]

Odpověď · 201

idstringpovinné

namestringpovinné

descriptionstring | nullpovinné

agendasobjectpovinné

salesstring

payrollstring

administrationstring

bankstring

cashstring

reportsstring

contactsstring

inventorystring

inboxstring

purchasesstring

assetsstring

travelstring

taxstring

agendasstring

ledgerstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

memberCountintegerpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

parentIdnull | string

deniedobject

formatsstring[]povinné

reportsstring[]povinné

POST/v1/access-roles

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

const response = await fetch('https://api.damedoklad.cz/v1/access-roles', {
  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.",
    "agendas": {}
  }),
});
const data = await response.json();

import os
import requests

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

Get one custom role with its rights

GET/v1/access-roles/{id}

Get one custom role with its rights

Nástroj MCP: get-access-role

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namestringpovinné

descriptionstring | nullpovinné

agendasobjectpovinné

salesstring

payrollstring

administrationstring

bankstring

cashstring

reportsstring

contactsstring

inventorystring

inboxstring

purchasesstring

assetsstring

travelstring

taxstring

agendasstring

ledgerstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

memberCountintegerpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

parentIdnull | string

deniedobject

formatsstring[]povinné

reportsstring[]povinné

GET/v1/access-roles/{id}

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

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

Change a custom role. It holds at once for everyone who has it, including their API keys and connected apps

PATCH/v1/access-roles/{id}

Change a custom role. It holds at once for everyone who has it, including their API keys and connected apps

Nástroj MCP: update-access-role

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

descriptionstring | null

agendasobject

scopesobject

warehousesstring[] | null

registersstring[] | null

accountsstring[] | null

seriesstring[] | null

centersstring[] | null

parentIdstring | null

ID of the parent.

deniedobject

formats"pdf" | "xlsx" | "csv" | "xml" | "zip"[]

reportsstring[]

Odpověď · 200

idstringpovinné

namestringpovinné

descriptionstring | nullpovinné

agendasobjectpovinné

salesstring

payrollstring

administrationstring

bankstring

cashstring

reportsstring

contactsstring

inventorystring

inboxstring

purchasesstring

assetsstring

travelstring

taxstring

agendasstring

ledgerstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

memberCountintegerpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

parentIdnull | string

deniedobject

formatsstring[]povinné

reportsstring[]povinné

PATCH/v1/access-roles/{id}

curl -X PATCH https://api.damedoklad.cz/v1/access-roles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "description": "Pečivo, říjen",
  "agendas": {}
}'

const response = await fetch('https://api.damedoklad.cz/v1/access-roles/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.",
    "description": "Pečivo, říjen",
    "agendas": {}
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/access-roles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "description": "Pečivo, říjen",
        "agendas": {}
    },
)
data = response.json()

Delete a custom role nobody has. A role in use is refused, so nobody is left without rights by accident

DELETE/v1/access-roles/{id}

Delete a custom role nobody has. A role in use is refused, so nobody is left without rights by accident

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

Nástroj MCP: delete-access-role

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/access-roles/{id}

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

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

What a custom role really comes to, with its parent applied: level per agenda and whether it is inherited, limits with their names, what it goes without, and who has it

GET/v1/access-roles/{id}/effective

What a custom role really comes to, with its parent applied: level per agenda and whether it is inherited, limits with their names, what it goes without, and who has it

Nástroj MCP: get-access-role-effective

Parametry v cestě

idstringpovinné

Odpověď · 200

rolenull | objectpovinné

idstringpovinné

namenull | stringpovinné

fixedRolenull | stringpovinné

parentnull | objectpovinné

idstringpovinné

namenull | stringpovinné

agendasobject[]povinné

keystringpovinné

levelstringpovinné

inheritedbooleanpovinné

scopesobjectpovinné

warehousesarray | nullpovinné

idstringpovinné

namenull | stringpovinné

registersanypovinné

Null in every recorded response.

accountsanypovinné

Null in every recorded response.

seriesanypovinné

Null in every recorded response.

centersanypovinné

Null in every recorded response.

deniedobjectpovinné

formatsstring[]povinné

reportsobject[]povinné

keystringpovinné

csstringpovinné

enstringpovinné

fixedOnlystring[]povinné

membersstring[]povinné

GET/v1/access-roles/{id}/effective

curl https://api.damedoklad.cz/v1/access-roles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/effective \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

List the agendas and levels a custom role can set, what each agenda needs to work, and the fixed roles written as rights to start from

GET/v1/access-roles/catalog

List the agendas and levels a custom role can set, what each agenda needs to work, and the fixed roles written as rights to start from

Nástroj MCP: get-access-catalog

Odpověď · 200

agendasobject[]povinné

keystringpovinné

needsstring[]povinné

ownboolean

levelsstring[]povinné

presetsobjectpovinné

ownerobjectpovinné

contactsstringpovinné

salesstringpovinné

purchasesstringpovinné

bankstringpovinné

cashstringpovinné

ledgerstringpovinné

taxstringpovinné

inventorystringpovinné

assetsstringpovinné

travelstringpovinné

payrollstringpovinné

agendasstringpovinné

reportsstringpovinné

inboxstringpovinné

administrationstringpovinné

accountantobjectpovinné

contactsstringpovinné

salesstringpovinné

purchasesstringpovinné

bankstringpovinné

cashstringpovinné

ledgerstringpovinné

taxstringpovinné

inventorystringpovinné

assetsstringpovinné

travelstringpovinné

payrollstringpovinné

agendasstringpovinné

reportsstringpovinné

inboxstringpovinné

administrationstringpovinné

invoicingobjectpovinné

contactsstringpovinné

salesstringpovinné

purchasesstringpovinné

bankstringpovinné

cashstringpovinné

ledgerstringpovinné

taxstringpovinné

inventorystringpovinné

assetsstringpovinné

travelstringpovinné

payrollstringpovinné

agendasstringpovinné

reportsstringpovinné

inboxstringpovinné

administrationstringpovinné

warehouseobjectpovinné

contactsstringpovinné

salesstringpovinné

purchasesstringpovinné

bankstringpovinné

cashstringpovinné

ledgerstringpovinné

taxstringpovinné

inventorystringpovinné

assetsstringpovinné

travelstringpovinné

payrollstringpovinné

agendasstringpovinné

reportsstringpovinné

inboxstringpovinné

administrationstringpovinné

readonlyobjectpovinné

contactsstringpovinné

salesstringpovinné

purchasesstringpovinné

bankstringpovinné

cashstringpovinné

ledgerstringpovinné

taxstringpovinné

inventorystringpovinné

assetsstringpovinné

travelstringpovinné

payrollstringpovinné

agendasstringpovinné

reportsstringpovinné

inboxstringpovinné

administrationstringpovinné

exportFormatsstring[]

printReportsobject[]

keystringpovinné

agendastringpovinné

csstringpovinné

enstringpovinné

GET/v1/access-roles/catalog

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

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

Seznam: aktivita

GET/v1/activity

List what happened in this company lately: documents issued, payments recorded, statements imported. Without IP addresses or technical calls; the full log is in the audit log

Nástroj MCP: list-activity

Parametry dotazu

limitintegermin 1max 100

Odpověď · 200

dataobject[]povinné

object"activity"povinné

idstringpovinné

actionstringpovinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

summarynull | stringpovinné

actorLabelnull | stringpovinné

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/activity

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

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

List API keys of this company. Secrets are never shown again after creation.

GET/v1/api-keys

List API keys of this company. Secrets are never shown again after creation.

Nástroj MCP: list-api-keys

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"api_key"povinné

idstringpovinné

namenull | stringpovinné

hintstringpovinné

scopestringpovinné

sendScopebooleanpovinné

lastUsedAtnull | stringpovinnédate-time

revokedAtstring | nullpovinné

createdAtstringpovinnédate-time

secretstring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/api-keys

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

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

Create an API key. scope "read" allows only reading, "full" also writing. sendScope lets it confirm payment orders and filings where an owner turned that on: only an owner in the dashboard can give it. The secret is returned once.

POST/v1/api-keys

Create an API key. scope "read" allows only reading, "full" also writing. sendScope lets it confirm payment orders and filings where an owner turned that on: only an owner in the dashboard can give it. The secret is returned once.

Nástroj MCP: create-api-key

Tělo požadavku

namestringpovinnémax 120 chars

scope"read" | "full"výchozí "full"

sendScopebooleanvýchozí false

Odpověď · 201

idstringpovinné

namenull | stringpovinné

hintstringpovinné

scopestringpovinné

sendScopebooleanpovinné

lastUsedAtnull | stringpovinnédate-time

revokedAtstring | nullpovinné

createdAtstringpovinnédate-time

secretstring

POST/v1/api-keys

curl -X POST https://api.damedoklad.cz/v1/api-keys \
  -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/api-keys', {
  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/api-keys",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Revoke an API key. Anything using it stops working immediately.

DELETE/v1/api-keys/{id}

Revoke an API key. Anything using it stops working immediately.

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

Nástroj MCP: revoke-api-key

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/api-keys/{id}

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

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

List the audit log: who did what, when, from which IP, on which object. Read only: entries can never be changed or deleted.

GET/v1/audit-events

List the audit log: who did what, when, from which IP, on which object. Read only: entries can never be changed or deleted.

Nástroj MCP: list-audit-events

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.

actionstringmax 100 chars

oidstringmax 64 chars

actorIdstringmax 64 chars

ID of the actor.

Odpověď · 200

dataobject[]povinné

object"audit_event"povinné

idstringpovinné

actionstringpovinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

summarynull | stringpovinné

diffanypovinné

actorTypestring

actorIdnull | string

actorLabelnull | string

ipnull | string

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/audit-events

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

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

The state of the tamper-evident chain: its latest hash, what waits to be sealed, and the last verification.

GET/v1/audit/chain

The state of the tamper-evident chain: its latest hash, what waits to be sealed, and the last verification.

Nástroj MCP: get-audit-chain

Odpověď · 200

lastnull | objectpovinné

okbooleanpovinné

reasonnull | stringpovinné

entriesintegerpovinné

waitingintegerpovinné

completebooleanpovinné

headHashnull | stringpovinné

brokenSeqinteger | nullpovinné

sealsCheckedintegerpovinné

verifiedAtstringpovinnédate-time

headHashnull | stringpovinné

headSeqintegerpovinné

sealedAtnull | stringpovinnédate-time

waitingintegerpovinné

GET/v1/audit/chain

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

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

The company's audit as a timeline: who did what, when and from where. One entry per request or job, including everything a trigger recorded. Ordinary reads are not recorded.

GET/v1/audit/entries

The company's audit as a timeline: who did what, when and from where. One entry per request or job, including everything a trigger recorded. Ordinary reads are not recorded.

Nástroj MCP: list-audit-entries

Parametry dotazu

actorIdstringmax 80 chars

ID of the actor.

agendastringmax 40 chars

objectTypestringmax 80 chars

objectIdstringmax 200 chars

ID of the object.

actionstringmax 40 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

searchstringmax 100 chars

locale"cs" | "en"

limitintegermin 1max 200

offsetintegermin 0max 9007199254740991

Odpověď · 200

dataobject[]povinné

object"audit_entry"povinné

idstringpovinné

createdAtstringpovinnédate-time

actorobjectpovinné

typestringpovinné

idnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

jobnull | stringpovinné

displaystringpovinné

behalfnull | objectpovinné

idstringpovinné

namenull | stringpovinné

emailnull | stringpovinné

supportstring | nullpovinné

whereobjectpovinné

surfacestringpovinné

surfaceLabelstringpovinné

operationIdnull | stringpovinné

methodnull | stringpovinné

routenull | stringpovinné

ipnull | stringpovinné

userAgentnull | stringpovinné

requestIdnull | stringpovinné

actionnull | stringpovinné

whatstringpovinné

subjectnull | objectpovinné

typenull | stringpovinné

typeLabelnull | stringpovinné

idstringpovinné

labelnull | stringpovinné

agendanull | stringpovinné

changeCountintegerpovinné

eventCountintegerpovinné

agendasobject[]

idstringpovinné

labelnull | stringpovinné

legacybooleanpovinné

directCountinteger

collapsedobject[]

tablestringpovinné

opstringpovinné

typeLabelstringpovinné

actionstringpovinné

actionLabelstringpovinné

countintegerpovinné

changesobject[]

object"audit_change"povinné

idintegerpovinné

tablestringpovinné

typeLabelstringpovinné

agendastringpovinné

agendaLabelstringpovinné

objectIdnull | stringpovinné

parentIdnull | stringpovinné

labelnull | stringpovinné

actionstringpovinné

actionLabelstringpovinné

fieldsobject[]povinné

fieldnull | stringpovinné

labelnull | stringpovinné

formatnull | stringpovinné

beforearray | integer | null | stringpovinné

hiddenboolean | nullpovinné

beforeLabelnull | string

afterLabelnull | string

beforeTextnull | string

afterTextnull | string

currencynull | string

eventsobject[]

object"audit_event"povinné

idstringpovinné

actionstringpovinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

summarynull | stringpovinné

diffanypovinné

actorTypestring

actorIdnull | string

actorLabelnull | string

ipnull | string

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/audit/entries

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

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

The filtered audit as CSV, up to 20 000 entries. The export itself is recorded.

GET/v1/audit/entries.csv

The filtered audit as CSV, up to 20 000 entries. The export itself is recorded.

Nástroj MCP: export-audit-csv

Parametry dotazu

actorIdstringmax 80 chars

ID of the actor.

agendastringmax 40 chars

objectTypestringmax 80 chars

objectIdstringmax 200 chars

ID of the object.

actionstringmax 40 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

searchstringmax 100 chars

locale"cs" | "en"

limitintegermin 1max 200

offsetintegermin 0max 9007199254740991

Odpověď · 200

Vrací soubor text/csv.

GET/v1/audit/entries.csv

curl https://api.damedoklad.cz/v1/audit/entries.csv \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

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

The filtered audit as XLSX, up to 20 000 entries. The export itself is recorded.

GET/v1/audit/entries.xlsx

The filtered audit as XLSX, up to 20 000 entries. The export itself is recorded.

Nástroj MCP: export-audit-xlsx

Parametry dotazu

actorIdstringmax 80 chars

ID of the actor.

agendastringmax 40 chars

objectTypestringmax 80 chars

objectIdstringmax 200 chars

ID of the object.

actionstringmax 40 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

searchstringmax 100 chars

locale"cs" | "en"

limitintegermin 1max 200

offsetintegermin 0max 9007199254740991

Odpověď · 200

Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.

GET/v1/audit/entries.xlsx

curl https://api.damedoklad.cz/v1/audit/entries.xlsx \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

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

One audit entry with every row it changed, field by field. A secret field says it changed and never its value.

GET/v1/audit/entries/{id}

One audit entry with every row it changed, field by field. A secret field says it changed and never its value.

Nástroj MCP: get-audit-entry

Parametry v cestě

idstringpovinné

Parametry dotazu

locale"cs" | "en"

tablestringmax 80 chars

op"I" | "U" | "D"

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

Odpověď · 200

idstringpovinné

createdAtstringpovinnédate-time

actorobjectpovinné

typestringpovinné

idnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

jobnull | stringpovinné

displaystringpovinné

behalfnull | objectpovinné

idstringpovinné

namenull | stringpovinné

emailnull | stringpovinné

supportstring | nullpovinné

whereobjectpovinné

surfacestringpovinné

surfaceLabelstringpovinné

operationIdnull | stringpovinné

methodnull | stringpovinné

routenull | stringpovinné

ipnull | stringpovinné

userAgentnull | stringpovinné

requestIdnull | stringpovinné

actionnull | stringpovinné

whatstringpovinné

subjectnull | objectpovinné

typenull | stringpovinné

typeLabelnull | stringpovinné

idstringpovinné

labelnull | stringpovinné

agendanull | stringpovinné

changeCountintegerpovinné

eventCountintegerpovinné

agendasobject[]

idstringpovinné

labelnull | stringpovinné

legacybooleanpovinné

directCountinteger

collapsedobject[]

tablestringpovinné

opstringpovinné

typeLabelstringpovinné

actionstringpovinné

actionLabelstringpovinné

countintegerpovinné

changesobject[]

object"audit_change"povinné

idintegerpovinné

tablestringpovinné

typeLabelstringpovinné

agendastringpovinné

agendaLabelstringpovinné

objectIdnull | stringpovinné

parentIdnull | stringpovinné

labelnull | stringpovinné

actionstringpovinné

actionLabelstringpovinné

fieldsobject[]povinné

fieldnull | stringpovinné

labelnull | stringpovinné

formatnull | stringpovinné

beforearray | integer | null | stringpovinné

itemsinteger

offersinteger

ordersinteger

pricesinteger

journalinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger | string

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsstring

saleVouchersinteger | string

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

hiddenboolean | nullpovinné

beforeLabelnull | string

afterLabelnull | string

beforeTextnull | string

afterTextnull | string

currencynull | string

eventsobject[]

object"audit_event"povinné

idstringpovinné

actionstringpovinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

summarynull | stringpovinné

diffanypovinné

actorTypestring

actorIdnull | string

actorLabelnull | string

ipnull | string

createdAtstringpovinnédate-time

GET/v1/audit/entries/{id}

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

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

What the audit can be filtered by: people and keys that appear in it, agendas, actions and surfaces.

GET/v1/audit/facets

What the audit can be filtered by: people and keys that appear in it, agendas, actions and surfaces.

Nástroj MCP: get-audit-facets

Parametry dotazu

locale"cs" | "en"

Odpověď · 200

actorsobject[]povinné

idstringpovinné

typestringpovinné

namenull | stringpovinné

emailnull | stringpovinné

labelnull | stringpovinné

agendasobject[]povinné

idstringpovinné

labelnull | stringpovinné

actionsobject[]povinné

idstringpovinné

labelnull | stringpovinné

surfacesobject[]povinné

idstringpovinné

labelnull | stringpovinné

GET/v1/audit/facets

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

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

The whole trail of one record: a document with its lines and payments, or a contact. Whoever may read the record may read this.

GET/v1/audit/objects/{id}/history

The whole trail of one record: a document with its lines and payments, or a contact. Whoever may read the record may read this.

Nástroj MCP: get-audit-history

Parametry v cestě

idstringpovinné

Parametry dotazu

locale"cs" | "en"

tablestringmax 80 chars

op"I" | "U" | "D"

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"audit_entry"povinné

idstringpovinné

createdAtstringpovinnédate-time

actorobjectpovinné

typestringpovinné

idnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

jobnull | stringpovinné

displaystringpovinné

behalfnull | objectpovinné

idstringpovinné

namenull | stringpovinné

emailnull | stringpovinné

supportstring | nullpovinné

whereobjectpovinné

surfacestringpovinné

surfaceLabelstringpovinné

operationIdnull | stringpovinné

methodnull | stringpovinné

routenull | stringpovinné

ipnull | stringpovinné

userAgentnull | stringpovinné

requestIdnull | stringpovinné

actionnull | stringpovinné

whatstringpovinné

subjectnull | objectpovinné

typenull | stringpovinné

typeLabelnull | stringpovinné

idstringpovinné

labelnull | stringpovinné

agendanull | stringpovinné

changeCountintegerpovinné

eventCountintegerpovinné

agendasobject[]

idstringpovinné

labelnull | stringpovinné

legacybooleanpovinné

directCountinteger

collapsedobject[]

tablestringpovinné

opstringpovinné

typeLabelstringpovinné

actionstringpovinné

actionLabelstringpovinné

countintegerpovinné

changesobject[]

object"audit_change"povinné

idintegerpovinné

tablestringpovinné

typeLabelstringpovinné

agendastringpovinné

agendaLabelstringpovinné

objectIdnull | stringpovinné

parentIdnull | stringpovinné

labelnull | stringpovinné

actionstringpovinné

actionLabelstringpovinné

fieldsobject[]povinné

fieldnull | stringpovinné

labelnull | stringpovinné

formatnull | stringpovinné

beforearray | integer | null | stringpovinné

hiddenboolean | nullpovinné

beforeLabelnull | string

afterLabelnull | string

beforeTextnull | string

afterTextnull | string

currencynull | string

eventsobject[]

object"audit_event"povinné

idstringpovinné

actionstringpovinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

summarynull | stringpovinné

diffanypovinné

actorTypestring

actorIdnull | string

actorLabelnull | string

ipnull | string

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/audit/objects/{id}/history

curl https://api.damedoklad.cz/v1/audit/objects/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/history \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Seals what is waiting and recomputes the company's hash chain against the recorded data. Answers the first thing that does not hold.

POST/v1/audit/verify

Seals what is waiting and recomputes the company's hash chain against the recorded data. Answers the first thing that does not hold.

Nástroj MCP: verify-audit-chain

Odpověď · 200

okbooleanpovinné

completebooleanpovinné

sealsCheckedintegerpovinné

entriesintegerpovinné

waitingintegerpovinné

headHashnull | stringpovinné

brokenSeqinteger | nullpovinné

reasonnull | stringpovinné

verifiedAtstringpovinnédate-time

POST/v1/audit/verify

curl -X POST https://api.damedoklad.cz/v1/audit/verify \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Show the current plan, trial, usage against limits, and whether online payment is available

GET/v1/billing

Show the current plan, trial, usage against limits, and whether online payment is available

Nástroj MCP: get-billing

Odpověď · 200

enabledbooleanpovinné

subscriptionobjectpovinné

object"billing_subscription"povinné

idnull | stringpovinné

planstringpovinné

statusstringpovinné

intervalnull | stringpovinné

trialEndsAtnull | stringpovinnédate-time

currentPeriodEndnull | stringpovinnédate-time

cancelAtPeriodEndbooleanpovinné

hasCustomerbooleanpovinné

planobjectpovinné

object"plan"povinné

idstringpovinné

namenull | objectpovinné

csstringpovinné

enstringpovinné

descriptionnull | objectpovinné

csstringpovinné

enstringpovinné

monthlyHalerintegerpovinné

yearlyHalerintegerpovinné

limitsobjectpovinné

documentsPerMonthinteger | nullpovinné

membersinteger | nullpovinné

featuresobjectpovinné

apibooleanpovinné

webhooksbooleanpovinné

inboxAibooleanpovinné

purchasablebooleanpovinné

usageobjectpovinné

documentsThisMonthintegerpovinné

membersintegerpovinné

plansobject[]povinné

object"plan"povinné

idstringpovinné

namenull | objectpovinné

csstringpovinné

enstringpovinné

descriptionnull | objectpovinné

csstringpovinné

enstringpovinné

monthlyHalerintegerpovinné

yearlyHalerintegerpovinné

limitsobjectpovinné

documentsPerMonthinteger | nullpovinné

membersinteger | nullpovinné

featuresobjectpovinné

apibooleanpovinné

webhooksbooleanpovinné

inboxAibooleanpovinné

purchasablebooleanpovinné

GET/v1/billing

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

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

Get the company profile: name, IČO, DIČ, address, VAT status, default bank account, document design

GET/v1/company

Get the company profile: name, IČO, DIČ, address, VAT status, default bank account, document design

Nástroj MCP: get-company

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

GET/v1/company

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

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

Update the company profile. The accounting regime has its own operation.

PATCH/v1/company

Update the company profile. The accounting regime has its own operation.

Nástroj MCP: update-company

Tělo požadavku

namestringmax 160 chars

icostring | null

Czech company number (IČO), 8 digits.

dicstring | null

VAT number (DIČ), for example CZ12345678.

streetstring | null

citystring | null

postalCodestring | null

countrystring2 chars

emailstring | null

phonestring | null

wwwstring | null

registerNotestring | null

vatPayerboolean

vatPeriod"monthly" | "quarterly"

defaultCurrencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

defaultLanguage"cs" | "en"

bankAccountobject

accountNumberstring | null

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

bankCodestring | null

ibanstring | null

IBAN without spaces.

swiftstring | null

designobject

accentColorstring | null

footerTextstring | null

showLogoboolean

showQrCodeboolean

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

PATCH/v1/company

curl -X PATCH https://api.damedoklad.cz/v1/company \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "ico": "12345678",
  "dic": "CZ12345678"
}'

const response = await fetch('https://api.damedoklad.cz/v1/company', {
  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.",
    "ico": "12345678",
    "dic": "CZ12345678"
  }),
});
const data = await response.json();

import os
import requests

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

Which agendas this company shows in the dashboard. Display only: the API and MCP reach every agenda whatever this says, and data is never removed. An agenda holding data or required by the regime stays visible

GET/v1/company/agendas

Which agendas this company shows in the dashboard. Display only: the API and MCP reach every agenda whatever this says, and data is never removed. An agenda holding data or required by the regime stays visible

Nástroj MCP: get-company-agendas

Odpověď · 200

showAllbooleanpovinné

chosenbooleanpovinné

agendasobject[]povinné

keystringpovinné

groupstringpovinné

parentnull | stringpovinné

lockedbooleanpovinné

hasDatabooleanpovinné

enabledbooleanpovinné

visiblebooleanpovinné

GET/v1/company/agendas

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

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

Turn agendas on or off in the dashboard, or show everything. Owner only. Nothing is removed, and an agenda holding data stays visible

PUT/v1/company/agendas

Turn agendas on or off in the dashboard, or show everything. Owner only. Nothing is removed, and an agenda holding data stays visible

Nástroj MCP: update-company-agendas

Tělo požadavku

showAllboolean

onstring[]

offstring[]

Odpověď · 200

showAllbooleanpovinné

chosenbooleanpovinné

agendasobject[]povinné

keystringpovinné

groupstringpovinné

parentnull | stringpovinné

lockedbooleanpovinné

hasDatabooleanpovinné

enabledbooleanpovinné

visiblebooleanpovinné

PUT/v1/company/agendas

curl -X PUT https://api.damedoklad.cz/v1/company/agendas \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "showAll": false,
  "on": [
    "string"
  ],
  "off": [
    "string"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/company/agendas', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "showAll": false,
    "on": [
      "string"
    ],
    "off": [
      "string"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/company/agendas",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "showAll": False,
        "on": [
            "string"
        ],
        "off": [
            "string"
        ]
    },
)
data = response.json()

Look up an IČO in ARES and return name, address and DIČ to prefill. Saves nothing.

POST/v1/company/ares

Look up an IČO in ARES and return name, address and DIČ to prefill. Saves nothing.

Nástroj MCP: lookup-company-in-ares

Tělo požadavku

icostringpovinné

Czech company number (IČO), 8 digits.

Odpověď · 200

sourcestringpovinné

iconull | stringpovinné

dicnull | stringpovinné

namenull | stringpovinné

vatPayerTypestringpovinné

addressnull | objectpovinné

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

POST/v1/company/ares

curl -X POST https://api.damedoklad.cz/v1/company/ares \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ico": "12345678"
}'

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

import os
import requests

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

Download the company logo

GET/v1/company/logo

Download the company logo

Nástroj MCP: get-company-logo

Odpověď · 200

Vrací soubor image/png.

GET/v1/company/logo

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

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

Upload the logo printed on documents (PNG or JPEG, up to 2 MB)

POST/v1/company/logo

Upload the logo printed on documents (PNG or JPEG, up to 2 MB)

Nástroj MCP: upload-company-logo

Tělo požadavku

contentType"image/png" | "image/jpeg"povinné

fileBase64stringpovinnémax 3145728 chars

File content encoded as base64.

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

POST/v1/company/logo

curl -X POST https://api.damedoklad.cz/v1/company/logo \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contentType": "image/png",
  "fileBase64": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/company/logo",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contentType": "image/png",
        "fileBase64": "string"
    },
)
data = response.json()

Change the accounting regime (daňová evidence, jednoduché, podvojné účetnictví). With entries in the books it can only be scheduled for the first day of a future period.

POST/v1/company/regime

Change the accounting regime (daňová evidence, jednoduché, podvojné účetnictví). With entries in the books it can only be scheduled for the first day of a future period.. Returns 409 regime_has_entries when the books hold entries and no valid effectiveFrom is given. This has tax consequences: confirm with the user.

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

Nástroj MCP: change-accounting-regime

Tělo požadavku

regime"tax_records" | "single_entry" | "double_entry"povinné

effectiveFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

POST/v1/company/regime

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

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

import os
import requests

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

Upload the company stamp a print layout can place as an element (PNG or JPEG, up to 2 MB)

POST/v1/company/stamp

Upload the company stamp a print layout can place as an element (PNG or JPEG, up to 2 MB)

Nástroj MCP: upload-company-stamp

Tělo požadavku

contentType"image/png" | "image/jpeg"povinné

fileBase64stringpovinnémax 3145728 chars

File content encoded as base64.

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

POST/v1/company/stamp

curl -X POST https://api.damedoklad.cz/v1/company/stamp \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contentType": "image/png",
  "fileBase64": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/company/stamp",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contentType": "image/png",
        "fileBase64": "string"
    },
)
data = response.json()

Forget the company stamp picture. A stamp on a layout then prints the company name and numbers in a frame

DELETE/v1/company/stamp

Forget the company stamp picture. A stamp on a layout then prints the company name and numbers in a frame

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

Nástroj MCP: delete-company-stamp

Odpověď · 200

idstringpovinné

sidstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

regimestringpovinné

vatPayerbooleanpovinné

vatPeriodstringpovinné

defaultCurrencystringpovinné

onboardedbooleanpovinné

scheduledRegimeChangenull | objectpovinné

regimestringpovinné

effectiveFromnull | stringpovinnédate

vatHistoryobject[]povinné

fromnull | stringpovinnédate

vatPayerbooleanpovinné

vatPeriodstringpovinné

notenull | string

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrynull | stringpovinné

emailnull | stringpovinné

phonenull | stringpovinné

wwwnull | stringpovinné

registerNoteanypovinné

Null in every recorded response.

defaultLanguagestringpovinné

bankAccountobjectpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | string

swiftstring | null

logoFileIdnull | stringpovinné

designobjectpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

logoPositionstring

createdAtstringpovinnédate-time

stampFileIdnull | string

DELETE/v1/company/stamp

curl -X DELETE https://api.damedoklad.cz/v1/company/stamp \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

List the comments on one document, oldest first

GET/v1/document-comments

List the comments on one document, oldest first

Nástroj MCP: list-document-comments

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.

documentIdstringpovinnémax 64 chars

ID of the document.

Odpověď · 200

dataobject[]povinné

object"document_comment"povinné

idstringpovinné

documentKindstringpovinné

documentIdstringpovinné

authorIdnull | stringpovinné

authorNamenull | stringpovinné

bodystringpovinné

resolvedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

minebooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/document-comments

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

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

Comment on a document. E-mails the other people who run the books here.

POST/v1/document-comments

Comment on a document. E-mails the other people who run the books here.

Nástroj MCP: create-document-comment

Tělo požadavku

documentIdstringpovinnémax 64 chars

ID of the document.

bodystringpovinnémax 4000 chars

Odpověď · 201

idstringpovinné

documentKindstringpovinné

documentIdstringpovinné

authorIdnull | stringpovinné

authorNamenull | stringpovinné

bodystringpovinné

resolvedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

minebooleanpovinné

POST/v1/document-comments

curl -X POST https://api.damedoklad.cz/v1/document-comments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentKind": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "body": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/document-comments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentKind": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "body": "string"
    },
)
data = response.json()

Delete your own comment

DELETE/v1/document-comments/{id}

Delete your own comment

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

Nástroj MCP: delete-document-comment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/document-comments/{id}

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

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

Mark a comment as dealt with, so it no longer counts as open

POST/v1/document-comments/{id}/resolve

Mark a comment as dealt with, so it no longer counts as open

Nástroj MCP: resolve-document-comment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

documentKindstringpovinné

documentIdstringpovinné

authorIdnull | stringpovinné

authorNamenull | stringpovinné

bodystringpovinné

resolvedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

minebooleanpovinné

POST/v1/document-comments/{id}/resolve

curl -X POST https://api.damedoklad.cz/v1/document-comments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/resolve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Export: doklad, účetnictví

GET/v1/document-exports

Download finished documents for another accounting system: POHODA XML, Money S3 XML, CSV with the journal, or ISDOC files in a ZIP. format=pohoda gives a dataPack of invoices, credit notes, advance invoices, orders, stock cards and stock documents. format=money_s3 gives MoneyData with issued and received invoices, orders, stock cards and stock documents; proformas have no place there. format=csv gives a ZIP of invoices, lines and journal. format=isdoc gives a ZIP of issued documents. Drafts and cancelled documents are left out. kinds narrows it: order, stock_card, stock_document only for the two XML formats.

Nástroj MCP: export-accounting-documents

Parametry dotazu

format"pohoda" | "money_s3" | "csv" | "isdoc"povinné

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

kindsstring

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/document-exports

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

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

List requests for documents in this company, newest first

GET/v1/document-requests

List requests for documents in this company, newest first

Nástroj MCP: list-document-requests

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"open" | "fulfilled" | "cancelled"

Odpověď · 200

dataobject[]povinné

object"document_request"povinné

idstringpovinné

titlestringpovinné

messagestring | nullpovinné

periodFromstring | nullpovinné

periodTostring | nullpovinné

dueOnstringpovinnédate

recipientsstring[]povinné

statusstringpovinné

reminderEveryDaysintegerpovinné

maxRemindersintegerpovinné

remindersSentintegerpovinné

nextReminderOnnull | stringpovinnédate

lastRemindedAtnull | stringpovinnédate-time

documentsReceivedintegerpovinné

fulfilledAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

failedRecipientsany[]

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/document-requests

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

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

Ask the client for documents and remind them by e-mail until they are in. Sends real e-mail; confirm the recipients first.

POST/v1/document-requests

Ask the client for documents and remind them by e-mail until they are in. Sends real e-mail; confirm the recipients first.

Nástroj MCP: create-document-request

Tělo požadavku

titlestringpovinnémax 160 chars

messagestringmax 2000 chars

periodFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

periodTostringYYYY-MM-DD

Date as YYYY-MM-DD.

dueOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

recipientsstring[]

reminderEveryDaysintegermin 1max 30výchozí 3

maxRemindersintegermin 0max 20výchozí 5

Odpověď · 201

idstringpovinné

titlestringpovinné

messagestring | nullpovinné

periodFromstring | nullpovinné

periodTostring | nullpovinné

dueOnstringpovinnédate

recipientsstring[]povinné

statusstringpovinné

reminderEveryDaysintegerpovinné

maxRemindersintegerpovinné

remindersSentintegerpovinné

nextReminderOnnull | stringpovinnédate

lastRemindedAtnull | stringpovinnédate-time

documentsReceivedintegerpovinné

fulfilledAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

failedRecipientsany[]

POST/v1/document-requests

curl -X POST https://api.damedoklad.cz/v1/document-requests \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "dueOn": "2026-10-30"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/document-requests",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "title": "string",
        "dueOn": "2026-10-30"
    },
)
data = response.json()

Withdraw a request for documents. Stops the reminders.

POST/v1/document-requests/{id}/cancel

Withdraw a request for documents. Stops the reminders.

Nástroj MCP: cancel-document-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

titlestringpovinné

messagestring | nullpovinné

periodFromstring | nullpovinné

periodTostring | nullpovinné

dueOnstringpovinnédate

recipientsstring[]povinné

statusstringpovinné

reminderEveryDaysintegerpovinné

maxRemindersintegerpovinné

remindersSentintegerpovinné

nextReminderOnnull | stringpovinnédate

lastRemindedAtnull | stringpovinnédate-time

documentsReceivedintegerpovinné

fulfilledAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

failedRecipientsany[]

POST/v1/document-requests/{id}/cancel

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

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

Say the requested documents are all in. Stops the reminders.

POST/v1/document-requests/{id}/fulfil

Say the requested documents are all in. Stops the reminders.

Nástroj MCP: fulfil-document-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

titlestringpovinné

messagestring | nullpovinné

periodFromstring | nullpovinné

periodTostring | nullpovinné

dueOnstringpovinnédate

recipientsstring[]povinné

statusstringpovinné

reminderEveryDaysintegerpovinné

maxRemindersintegerpovinné

remindersSentintegerpovinné

nextReminderOnnull | stringpovinnédate

lastRemindedAtnull | stringpovinnédate-time

documentsReceivedintegerpovinné

fulfilledAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

failedRecipientsany[]

POST/v1/document-requests/{id}/fulfil

curl -X POST https://api.damedoklad.cz/v1/document-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fulfil \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

List workspace exports, newest first

GET/v1/exports

List workspace exports, newest first

Nástroj MCP: list-data-exports

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"data_export"povinné

idstringpovinné

statusstringpovinné

byteSizeinteger | nullpovinné

summarynull | objectpovinné

pdfsintegerpovinné

filesintegerpovinné

tablesobjectpovinné

bomsinteger

filesintegerpovinné

itemsinteger

assetsinteger

leasesinteger

seriesintegerpovinné

periodsintegerpovinné

accountsintegerpovinné

contactsintegerpovinné

invoicesintegerpovinné

vehiclesinteger

bom_linesinteger

employeesinteger

movementsinteger

proformasinteger

dimensionsinteger

stock_lotsinteger

stocktakesinteger

warehousesinteger

credentialsintegerpovinné

audit_eventsintegerpovinné

credit_notesinteger

data_exportsintegerpovinné

stock_layersinteger

tax_profilesinteger

bank_accountsinteger

cash_countersinteger

invoice_linesintegerpovinné

journal_linesintegerpovinné

movement_lotsinteger

travel_ordersinteger

bank_movementsinteger

cash_documentsinteger

cash_registersinteger

contact_groupsinteger

delivery_notesinteger

import_batchesinteger

proforma_linesinteger

stock_balancesinteger

user_workspaceintegerpovinné

vehicle_routesinteger

inbox_documentsintegerpovinné

journal_entriesintegerpovinné

movement_layersinteger

stock_documentsinteger

stocktake_linesinteger

bank_allocationsinteger

invoice_paymentsinteger

credit_note_linesinteger

invoice_vat_linesintegerpovinné

lease_instalmentsinteger

received_invoicesinteger

proforma_vat_linesinteger

stock_lot_balancesinteger

stock_reservationsinteger

delivery_note_linesinteger

stock_number_seriesinteger

accounting_templatesintegerpovinné

credit_note_paymentsinteger

employment_contractsinteger

stock_document_linesinteger

received_invoice_linesinteger

received_invoice_vat_linesinteger

received_invoice_settlementsinteger

contact_addressesinteger

webhook_endpointsinteger

warningsany[]povinné

errorstring | nullpovinné

createdAtstringpovinnédate-time

finishedAtnull | stringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/exports

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

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

Start a full export of this company: a ZIP of JSON, spreadsheets, document PDFs and attachments, built in the background

POST/v1/exports

Start a full export of this company: a ZIP of JSON, spreadsheets, document PDFs and attachments, built in the background

Nástroj MCP: create-data-export

Odpověď · 202

idstringpovinné

statusstringpovinné

byteSizeinteger | nullpovinné

summarynull | objectpovinné

pdfsintegerpovinné

filesintegerpovinné

tablesobjectpovinné

bomsinteger

filesintegerpovinné

itemsinteger

assetsinteger

leasesinteger

seriesintegerpovinné

periodsintegerpovinné

accountsintegerpovinné

contactsintegerpovinné

invoicesintegerpovinné

vehiclesinteger

bom_linesinteger

employeesinteger

movementsinteger

proformasinteger

dimensionsinteger

stock_lotsinteger

stocktakesinteger

warehousesinteger

credentialsintegerpovinné

audit_eventsintegerpovinné

credit_notesinteger

data_exportsintegerpovinné

stock_layersinteger

tax_profilesinteger

bank_accountsinteger

cash_countersinteger

invoice_linesintegerpovinné

journal_linesintegerpovinné

movement_lotsinteger

travel_ordersinteger

bank_movementsinteger

cash_documentsinteger

cash_registersinteger

contact_groupsinteger

delivery_notesinteger

import_batchesinteger

proforma_linesinteger

stock_balancesinteger

user_workspaceintegerpovinné

vehicle_routesinteger

inbox_documentsintegerpovinné

journal_entriesintegerpovinné

movement_layersinteger

stock_documentsinteger

stocktake_linesinteger

bank_allocationsinteger

invoice_paymentsinteger

credit_note_linesinteger

invoice_vat_linesintegerpovinné

lease_instalmentsinteger

received_invoicesinteger

proforma_vat_linesinteger

stock_lot_balancesinteger

stock_reservationsinteger

delivery_note_linesinteger

stock_number_seriesinteger

accounting_templatesintegerpovinné

credit_note_paymentsinteger

employment_contractsinteger

stock_document_linesinteger

received_invoice_linesinteger

received_invoice_vat_linesinteger

received_invoice_settlementsinteger

contact_addressesinteger

webhook_endpointsinteger

warningsany[]povinné

errorstring | nullpovinné

createdAtstringpovinnédate-time

finishedAtnull | stringpovinnédate-time

POST/v1/exports

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

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

Get the status of a workspace export

GET/v1/exports/{id}

Get the status of a workspace export

Nástroj MCP: get-data-export

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

statusstringpovinné

byteSizeinteger | nullpovinné

summarynull | objectpovinné

pdfsintegerpovinné

filesintegerpovinné

tablesobjectpovinné

bomsinteger

filesintegerpovinné

itemsinteger

assetsinteger

leasesinteger

seriesintegerpovinné

periodsintegerpovinné

accountsintegerpovinné

contactsintegerpovinné

invoicesintegerpovinné

vehiclesinteger

bom_linesinteger

employeesinteger

movementsinteger

proformasinteger

dimensionsinteger

stock_lotsinteger

stocktakesinteger

warehousesinteger

credentialsintegerpovinné

audit_eventsintegerpovinné

credit_notesinteger

data_exportsintegerpovinné

stock_layersinteger

tax_profilesinteger

bank_accountsinteger

cash_countersinteger

invoice_linesintegerpovinné

journal_linesintegerpovinné

movement_lotsinteger

travel_ordersinteger

bank_movementsinteger

cash_documentsinteger

cash_registersinteger

contact_groupsinteger

delivery_notesinteger

import_batchesinteger

proforma_linesinteger

stock_balancesinteger

user_workspaceintegerpovinné

vehicle_routesinteger

inbox_documentsintegerpovinné

journal_entriesintegerpovinné

movement_layersinteger

stock_documentsinteger

stocktake_linesinteger

bank_allocationsinteger

invoice_paymentsinteger

credit_note_linesinteger

invoice_vat_linesintegerpovinné

lease_instalmentsinteger

received_invoicesinteger

proforma_vat_linesinteger

stock_lot_balancesinteger

stock_reservationsinteger

delivery_note_linesinteger

stock_number_seriesinteger

accounting_templatesintegerpovinné

credit_note_paymentsinteger

employment_contractsinteger

stock_document_linesinteger

received_invoice_linesinteger

received_invoice_vat_linesinteger

received_invoice_settlementsinteger

contact_addressesinteger

webhook_endpointsinteger

warningsany[]povinné

errorstring | nullpovinné

createdAtstringpovinnédate-time

finishedAtnull | stringpovinnédate-time

GET/v1/exports/{id}

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

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

Download a finished workspace export as a ZIP

GET/v1/exports/{id}/download

Download a finished workspace export as a ZIP

Nástroj MCP: download-data-export

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/zip.

GET/v1/exports/{id}/download

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

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

List imports, newest first

GET/v1/imports

List imports, newest first

Nástroj MCP: list-imports

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"import_batch"povinné

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

bankobject

vouchersobject

ordersobject

offersobject

stock_documentsobject

stockobject

accountsobject

postingsobject

dimensionsobject

price_listsobject

journalobject

invoicesobject

opening_balancesobject

fixed_assetsobject

enquiriesobject

productionsobject

sale_vouchersobject

stock_transfersobject

internal_documentsobject

product_dataobject

moneyobject

incomeobject

expensesobject

payablesobject

receivablesobject

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/imports

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

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

Upload a POHODA XML, XLSX or CSV file and get a dry-run report of what importing it would do. Changes nothing yet.

POST/v1/imports

Upload a POHODA XML, XLSX or CSV file and get a dry-run report of what importing it would do. Changes nothing yet.. source=pohoda reads a dataPack or responsePack: adresář, faktury, zásoby, účetní deník, pokladna, banka, objednávky, nabídky, příjemky, výdejky, převodky, výroba, prodejky, poptávky, interní doklady, ceníky, účtová osnova, předkontace, střediska, činnosti, zakázky. With kind=opening_from_journal it turns a deník into opening balances at openingDate. source=tabular needs kind contacts, opening_balances or fixed_assets.

Nástroj MCP: create-import

Tělo požadavku

source"pohoda" | "tabular"povinné

kind"contacts" | "opening_balances" | "fixed_assets" | "opening_from_journal"

filenamestringpovinnémax 200 chars

fileBase64stringpovinnémax 62914560 chars

File content encoded as base64.

openingDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

POST/v1/imports

curl -X POST https://api.damedoklad.cz/v1/imports \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "source": "pohoda",
  "filename": "Pekárna U Lípy s.r.o.",
  "fileBase64": "string"
}'

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

import os
import requests

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

Get an import with its dry-run report and result

GET/v1/imports/{id}

Get an import with its dry-run report and result

Nástroj MCP: get-import

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

GET/v1/imports/{id}

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

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

Run an import after its dry run. All or nothing. Posting a journal or opening balances writes to the books.

POST/v1/imports/{id}/apply

Run an import after its dry run. All or nothing. Posting a journal or opening balances writes to the books.

Nástroj MCP: apply-import

Parametry v cestě

idstringpovinné

Tělo požadavku

importStockQuantitiesbooleanvýchozí true

Odpověď · 202

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

POST/v1/imports/{id}/apply

curl -X POST https://api.damedoklad.cz/v1/imports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/apply \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sections": [
    "accounts"
  ],
  "importStockQuantities": true
}'

const response = await fetch('https://api.damedoklad.cz/v1/imports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/apply', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "sections": [
      "accounts"
    ],
    "importStockQuantities": true
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/imports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/apply",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "sections": [
            "accounts"
        ],
        "importStockQuantities": True
    },
)
data = response.json()

Compare what a POHODA file says with what is in the books now, section by section: counts, totals, missing documents and differences

GET/v1/imports/{id}/reconciliation

Compare what a POHODA file says with what is in the books now, section by section: counts, totals, missing documents and differences

Nástroj MCP: get-import-reconciliation

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

statusstringpovinné

balancedbooleanpovinné

sectionsobject[]povinné

keystringpovinné

labelnull | stringpovinné

pohodaCountintegerpovinné

oursCountintegerpovinné

totalsobject[]povinné

currencynull | stringpovinné

pohodaHalerintegerpovinné

oursHalerintegerpovinné

differenceHalerintegerpovinné

missingobject[]povinné

numbernull | stringpovinné

currencynull | string

pohodaHalerinteger

differentobject[]povinné

numbernull | stringpovinné

currencynull | stringpovinné

pohodaHalerintegerpovinné

oursHalerintegerpovinné

differenceHalerintegerpovinné

skippedintegerpovinné

balancedbooleanpovinné

accountsobject[]povinné

accountNumbernull | stringpovinné

pohodaDebitHalerintegerpovinné

pohodaCreditHalerintegerpovinné

oursDebitHalerintegerpovinné

oursCreditHalerintegerpovinné

differenceHalerintegerpovinné

GET/v1/imports/{id}/reconciliation

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

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

Say whether an applied import can still be undone, and what stands in the way

GET/v1/imports/{id}/undo

Say whether an applied import can still be undone, and what stands in the way

Nástroj MCP: get-import-undo-check

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

possiblebooleanpovinné

reasonnull | stringpovinné

blockersobject[]povinné

objectTypenull | stringpovinné

objectIdnull | stringpovinné

reasonnull | stringpovinné

countsobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

received_invoiceinteger

blockerCountinteger

GET/v1/imports/{id}/undo

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

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

Undo a whole import while nothing has been built on it. Removes what it created and reverses what it posted. All or nothing.

POST/v1/imports/{id}/undo

Undo a whole import while nothing has been built on it. Removes what it created and reverses what it posted. All or nothing.

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

Nástroj MCP: undo-import

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

POST/v1/imports/{id}/undo

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

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

POHODA documents kept as history without an agenda of their own: interní doklady and received enquiries

GET/v1/imports/documents

POHODA documents kept as history without an agenda of their own: interní doklady and received enquiries

Nástroj MCP: list-imported-documents

Parametry dotazu

kind"internal_document" | "received_enquiry"

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"imported_document"povinné

idstringpovinné

kindstringpovinné

numberstringpovinné

datestringpovinnédate

descriptionnull | stringpovinné

contactNamenull | stringpovinné

currencystringpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

linesobject[]povinné

unitnull | stringpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

descriptionnull | stringpovinné

quantityMilliinteger | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/imports/documents

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

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

Mid-year transition for tax records and single entry: balances of accounts and registers, open receivables and payables, income and expenses so far. Returns a dry-run report. Changes nothing until the import is applied

POST/v1/imports/mid-year

Mid-year transition for tax records and single entry: balances of accounts and registers, open receivables and payables, income and expenses so far. Returns a dry-run report. Changes nothing until the import is applied

Nástroj MCP: create-mid-year-transition

Tělo požadavku

openingDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

bankAccountsobject[]

idstringpovinné

balanceHalerintegerpovinnémin -9007199254740991max 9007199254740991

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

cashRegistersobject[]

idstringpovinné

balanceHalerintegerpovinnémin 0max 9007199254740991

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

receivablesobject[]

numberstringpovinnémax 60 chars

contactNamestringpovinnémax 200 chars

icostring

Czech company number (IČO), 8 digits.

issueDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

amountHalerintegerpovinnémin 1max 9007199254740991

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

vatHalerintegermin 0max 9007199254740991

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

payablesobject[]

numberstringpovinnémax 60 chars

contactNamestringpovinnémax 200 chars

icostring

Czech company number (IČO), 8 digits.

issueDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

amountHalerintegerpovinnémin 1max 9007199254740991

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

vatHalerintegermin 0max 9007199254740991

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

incomeobject[]

descriptionstringpovinnémax 200 chars

amountHalerintegerpovinnémin 1max 9007199254740991

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

vatHalerintegermin 0max 9007199254740991

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

classification"income_taxable" | "income_exempt" | "expense_deductible" | "expense_nondeductible"

categorystringmax 60 chars

activityKind"main" | "economic"

moneyAccount"bank" | "cash"

expensesobject[]

descriptionstringpovinnémax 200 chars

amountHalerintegerpovinnémin 1max 9007199254740991

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

vatHalerintegermin 0max 9007199254740991

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

classification"income_taxable" | "income_exempt" | "expense_deductible" | "expense_nondeductible"

categorystringmax 60 chars

activityKind"main" | "economic"

moneyAccount"bank" | "cash"

Odpověď · 201

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

POST/v1/imports/mid-year

curl -X POST https://api.damedoklad.cz/v1/imports/mid-year \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "openingDate": "2026-10-30"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/imports/mid-year",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "openingDate": "2026-10-30"
    },
)
data = response.json()

Type opening balances for a mid-year switch and get a dry-run report. Changes nothing until the import is applied.

POST/v1/imports/opening-balances

Type opening balances for a mid-year switch and get a dry-run report. Changes nothing until the import is applied.

Nástroj MCP: create-typed-opening-balances

Tělo požadavku

openingDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

linesobject[]povinné

accountNumberstringpovinné

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

accountNamestringmax 200 chars

debitHalerintegermin 0max 9007199254740991výchozí 0

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

creditHalerintegermin 0max 9007199254740991výchozí 0

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

Odpověď · 201

idstringpovinné

sourcestringpovinné

kindstringpovinné

filenamenull | stringpovinné

statusstringpovinné

reportobjectpovinné

formatstring

sectionsobjectpovinné

contactsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

bankobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

ordersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

offersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

stock_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stockobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

accountsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

postingsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

dimensionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

price_listsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

journalobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

invoicesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

opening_balancesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

fixed_assetsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

enquiriesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

productionsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

sale_vouchersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

stock_transfersobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

internal_documentsobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

product_dataobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

moneyobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesany[]povinné

warningsany[]povinné

incomeobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsstring[]povinné

expensesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsany[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

payablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

receivablesobject

skipintegerpovinné

labelnull | stringpovinné

totalintegerpovinné

createintegerpovinné

errorsstring[]povinné

updateintegerpovinné

samplesobject[]povinné

warningsany[]povinné

warningsstring[]

sourceIconull | string

applicationnull | string

unsupportedobject

claiminteger

balanceItemsinteger

balancedboolean

debitHalerinteger

creditHalerinteger

openingDatenull | stringdate

unknownColumnsstring[]

taxBaseSoFarHalerinteger

resultnull | objectpovinné

linesinteger

journalinteger

itemsinteger

offersinteger

ordersinteger

pricesinteger

accountsinteger

archivedinteger

contactsinteger

invoicesinteger

postingsinteger

vouchersinteger

enquiriesinteger

movementsinteger

dimensionsinteger

priceListsinteger

warehousesinteger

productionsinteger

bankAccountsinteger

saleVouchersinteger

bankMovementsinteger

cashRegistersinteger

stockDocumentsinteger

stockTransfersinteger

contactsUpdatedinteger

fixedAssetsinteger

gpsrinteger

customFieldsinteger

recyclingFeesinteger

incomeinteger

expensesinteger

payablesinteger

registersinteger

receivablesinteger

errornull | stringpovinné

createdAtstringpovinnédate-time

appliedAtnull | stringpovinnédate-time

undoneAtnull | stringpovinnédate-time

undoobject

removedobjectpovinné

contactinteger

dimensioninteger

invoiceinteger

iteminteger

warehouseinteger

assetinteger

stock_documentinteger

sales_documentinteger

imported_documentinteger

gpsr_recordinteger

recycling_feeinteger

custom_fieldinteger

received_invoiceinteger

cash_book_entryinteger

book_balance_openinginteger

reversedEntriesintegerpovinné

keptAccountsintegerpovinné

keptDimensionsintegerpovinné

POST/v1/imports/opening-balances

curl -X POST https://api.damedoklad.cz/v1/imports/opening-balances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "openingDate": "2026-10-30",
  "lines": [
    {
      "accountNumber": "string"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/imports/opening-balances', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "openingDate": "2026-10-30",
    "lines": [
      {
        "accountNumber": "string"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/imports/opening-balances",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "openingDate": "2026-10-30",
        "lines": [
            {
                "accountNumber": "string"
            }
        ]
    },
)
data = response.json()

Detail: adresa, k vyřízení

GET/v1/inbox/address

Get the e-mail address that puts received attachments into this queue

Nástroj MCP: get-inbox-address

Odpověď · 200

addressnull | stringpovinné

enabledbooleanpovinné

aiEnabledboolean

GET/v1/inbox/address

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

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

Replace the company address with a new one, for when the old one leaked. Mail to the old address stops being accepted.

POST/v1/inbox/address/rotate

Replace the company address with a new one, for when the old one leaked. Mail to the old address stops being accepted.

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

Nástroj MCP: rotate-inbox-address

Odpověď · 200

addressnull | stringpovinné

enabledbooleanpovinné

aiEnabledboolean

POST/v1/inbox/address/rotate

curl -X POST https://api.damedoklad.cz/v1/inbox/address/rotate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Seznam: doklad, k vyřízení

GET/v1/inbox/documents

List received documents in the queue. By default those not finished yet.

Nástroj MCP: list-inbox-documents

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

status"new" | "done" | "discarded"

Odpověď · 200

dataobject[]povinné

object"inbox_document"povinné

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

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/inbox/documents

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

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

Add a received document (PDF, image, or ISDOC, base64, up to 25 MB) to the queue. Values are read from it automatically.

POST/v1/inbox/documents

Add a received document (PDF, image, or ISDOC, base64, up to 25 MB) to the queue. Values are read from it automatically.

Nástroj MCP: upload-inbox-document

Tělo požadavku

requestIdstringmax 64 chars

ID of the request.

filenamestringpovinnémax 200 chars

contentTypestringmax 100 chars

fileBase64stringpovinnémax 62914560 chars

File content encoded as base64.

Odpověď · 201

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

createdAtstringpovinnédate-time

POST/v1/inbox/documents

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

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

import os
import requests

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

Detail: doklad, k vyřízení

GET/v1/inbox/documents/{id}

Get a received document with the values read from it

Nástroj MCP: get-inbox-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

createdAtstringpovinnédate-time

GET/v1/inbox/documents/{id}

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

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

Úprava: doklad, k vyřízení

PATCH/v1/inbox/documents/{id}

Correct the values read from a received document before creating the invoice

Nástroj MCP: update-inbox-document

Parametry v cestě

idstringpovinné

Tělo požadavku

supplierNamestring | null

supplierIcostring | null

Czech company number (IČO), 8 digits.

supplierDicstring | null

VAT number (DIČ), for example CZ12345678.

documentNumberstring | null

variableSymbolstring | null

issueDatestring | null

Date as YYYY-MM-DD.

taxPointDatestring | null

Date as YYYY-MM-DD.

dueDatestring | null

Date as YYYY-MM-DD.

currencystring | null

ISO 4217 currency code, for example CZK or EUR.

netHalerinteger | null

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

vatHalerinteger | null

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

totalHalerinteger | null

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

accountNumberstring | null

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

bankCodestring | null

ibanstring | null

IBAN without spaces.

Odpověď · 200

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

createdAtstringpovinnédate-time

PATCH/v1/inbox/documents/{id}

curl -X PATCH https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierName": "Pekárna U Lípy s.r.o.",
  "supplierIco": "12345678",
  "supplierDic": "CZ12345678"
}'

const response = await fetch('https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "supplierName": "Pekárna U Lípy s.r.o.",
    "supplierIco": "12345678",
    "supplierDic": "CZ12345678"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "supplierName": "Pekárna U Lípy s.r.o.",
        "supplierIco": "12345678",
        "supplierDic": "CZ12345678"
    },
)
data = response.json()

Take a document out of the queue without creating anything. The file is kept.

POST/v1/inbox/documents/{id}/discard

Take a document out of the queue without creating anything. The file is kept.

Nástroj MCP: discard-inbox-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

createdAtstringpovinnédate-time

POST/v1/inbox/documents/{id}/discard

curl -X POST https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/discard \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Read the values from a received document again

POST/v1/inbox/documents/{id}/extract

Read the values from a received document again

Nástroj MCP: extract-inbox-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

filenamestringpovinné

sourcestringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

fileIdstringpovinné

extractionSourcenull | stringpovinné

extractionnull | objectpovinné

ibanstring | null

dueDatenull | stringdate

bankCodenull | string

currencynull | string

netHalerinteger | nullpovinné

vatHalerinteger | nullpovinné

vatLinesobject[]povinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

issueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

supplierDicnull | string

supplierIconull | string

documentTypeinteger | null

payableHalerinteger | null

supplierCityany

Null in every recorded response.

supplierNamenull | stringpovinné

taxPointDatenull | stringdate

accountNumbernull | string

documentNumbernull | stringpovinné

supplierStreetany

Null in every recorded response.

variableSymbolnull | string

supplierPostalCodeany

Null in every recorded response.

isInvoiceboolean

extractionErrornull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

requestIdnull | stringpovinné

hasCompanionbooleanpovinné

createdAtstringpovinnédate-time

POST/v1/inbox/documents/{id}/extract

curl -X POST https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/extract \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Detail: soubor, doklad, k vyřízení

GET/v1/inbox/documents/{id}/file

Download the attachment of a received document

Nástroj MCP: get-inbox-document-file

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/inbox/documents/{id}/file

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

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

Create a received invoice from a document in the queue and attach the file. Posts to the books unless record is false.

POST/v1/inbox/documents/{id}/received-invoice

Create a received invoice from a document in the queue and attach the file. Posts to the books unless record is false.. Recording posts to the books. Confirm the supplier, number, dates and amounts with the user first.

Nástroj MCP: create-received-invoice-from-inbox

Parametry v cestě

idstringpovinné

Tělo požadavku

recordbooleanvýchozí true

confirmDuplicateboolean

Odpověď · 201

idstringpovinné

receivedInvoiceIdnull | string

totalHalerinteger | nullpovinné

differenceHalerintegerpovinné

supplierAdvanceIdnull | string

POST/v1/inbox/documents/{id}/received-invoice

curl -X POST https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/received-invoice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "record": true,
  "confirmDuplicate": false
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/received-invoice",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "record": True,
        "confirmDuplicate": False
    },
)
data = response.json()

Create an advance to a supplier from a document in the queue, such as a supplier's zálohová faktura read from ISDOC, and attach the file. Posts nothing until it is paid.

POST/v1/inbox/documents/{id}/supplier-advance

Create an advance to a supplier from a document in the queue, such as a supplier's zálohová faktura read from ISDOC, and attach the file. Posts nothing until it is paid.. A zálohová faktura is not a tax document: no VAT is claimed from it. The amounts become the lines of the advance; its payment and the supplier's tax document follow on the advance.

Nástroj MCP: create-supplier-advance-from-inbox

Parametry v cestě

idstringpovinné

Tělo požadavku

recordbooleanvýchozí true

confirmDuplicateboolean

advanceAccount"151" | "152" | "153" | "314" | "051" | "052"

Odpověď · 201

idstringpovinné

receivedInvoiceIdnull | string

totalHalerinteger | nullpovinné

differenceHalerintegerpovinné

supplierAdvanceIdnull | string

POST/v1/inbox/documents/{id}/supplier-advance

curl -X POST https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/supplier-advance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "record": true,
  "confirmDuplicate": false,
  "advanceAccount": "151"
}'

const response = await fetch('https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/supplier-advance', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "record": true,
    "confirmDuplicate": false,
    "advanceAccount": "151"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/supplier-advance",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "record": True,
        "confirmDuplicate": False,
        "advanceAccount": "151"
    },
)
data = response.json()

See who may send documents to the company address

GET/v1/inbox/email-settings

See who may send documents to the company address

Nástroj MCP: get-inbound-email-settings

Odpověď · 200

modestringpovinné

allowListstring[]povinné

GET/v1/inbox/email-settings

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

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

Set who may send documents to the company address: anyone, or only listed addresses and @domains. The company's own people are always allowed.

PUT/v1/inbox/email-settings

Set who may send documents to the company address: anyone, or only listed addresses and @domains. The company's own people are always allowed.

Nástroj MCP: update-inbound-email-settings

Tělo požadavku

mode"any" | "allow_list"povinné

allowListstring[]výchozí []

Odpověď · 200

modestringpovinné

allowListstring[]povinné

PUT/v1/inbox/email-settings

curl -X PUT https://api.damedoklad.cz/v1/inbox/email-settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "any"
}'

const response = await fetch('https://api.damedoklad.cz/v1/inbox/email-settings', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mode": "any"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/inbox/email-settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "mode": "any"
    },
)
data = response.json()

List what arrived at the company address, including mail that was refused or held no documents

GET/v1/inbox/emails

List what arrived at the company address, including mail that was refused or held no documents

Nástroj MCP: list-inbound-emails

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"inbound_email"povinné

idstringpovinné

sendernull | stringpovinné

subjectnull | stringpovinné

statusstringpovinné

receivedCountintegerpovinné

duplicateCountintegerpovinné

skippedobject[]povinné

reasonnull | stringpovinné

filenamenull | stringpovinné

documentIdsstring[]povinné

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/inbox/emails

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

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

Count what is waiting to be finished: received documents in the queue, drafts, unmatched bank movements, overdue invoices

GET/v1/inbox/summary

Count what is waiting to be finished: received documents in the queue, drafts, unmatched bank movements, overdue invoices

Nástroj MCP: get-inbox-summary

Odpověď · 200

documentsintegerpovinné

draftsintegerpovinné

movementsintegerpovinné

overdueintegerpovinné

totalintegerpovinné

GET/v1/inbox/summary

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

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

One to-do list: documents to finish, drafts, overdue invoices, and upcoming tax deadlines, each with where to go next

GET/v1/inbox/todo

One to-do list: documents to finish, drafts, overdue invoices, and upcoming tax deadlines, each with where to go next

Nástroj MCP: list-inbox-todo

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

kindstringpovinné

idstringpovinné

titlenull | stringpovinné

subtitlestring

amountHalerinteger | null

currencynull | string

datenull | stringpovinnédate

pathnull | stringpovinné

subtitleEnstring

directionstring

deadlinestring

titleEnstring

selfAssessboolean

overdueboolean

approvalIdstring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/inbox/todo

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

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

Seznam: pozvánka

GET/v1/invitations

List invitations nobody has accepted yet

Nástroj MCP: list-invitations

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

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/invitations

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

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

Cancel an invitation so its link stops working

DELETE/v1/invitations/{id}

Cancel an invitation so its link stops working

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

Nástroj MCP: revoke-invitation

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/invitations/{id}

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

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

Send an invitation again with a new link and a fresh expiry

POST/v1/invitations/{id}/resend

Send an invitation again with a new link and a fresh expiry

Nástroj MCP: resend-invitation

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

emailnull | stringpovinné

rolestringpovinné

accessRoleIdnull | string

expiresAtstringpovinnédate-time

expiredbooleanpovinné

createdAtstringpovinnédate-time

tokenstring

POST/v1/invitations/{id}/resend

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

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

List the mailboxes read into K vyřízení, with when each was last read and any problem. Passwords are never returned

GET/v1/mailboxes

List the mailboxes read into K vyřízení, with when each was last read and any problem. Passwords are never returned

Nástroj MCP: list-mailboxes

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"mailbox"povinné

idstringpovinné

providernull | stringpovinné

emailnull | stringpovinné

labelstring | nullpovinné

hostnull | stringpovinné

portinteger | nullpovinné

securitynull | stringpovinné

usernamenull | stringpovinné

foldernull | stringpovinné

statusstringpovinné

errorCodenull | stringpovinné

lastSyncAtnull | stringpovinnédate-time

readFromstringpovinnédate

createdAtstringpovinnédate-time

foldersstring[]

keepMessagesboolean

smtpHostnull | string

smtpPortinteger | null

smtpSecuritynull | string

smtpUsernamestring | null

sendingReadyboolean

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/mailboxes

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

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

Connect a mailbox over IMAP with a password: tests the login first, stores the password encrypted, and from then on reads new attachments into K vyřízení. Nothing on the mail server changes

POST/v1/mailboxes

Connect a mailbox over IMAP with a password: tests the login first, stores the password encrypted, and from then on reads new attachments into K vyřízení. Nothing on the mail server changes. Only public servers on the standard ports. The company’s sender rules from the inbound e-mail settings apply. Reads back 30 days on the first run unless readFrom says otherwise.

Nástroj MCP: connect-mailbox

Tělo požadavku

emailstringpovinnéemail

labelstring | null

hoststringpovinnémin 3 charsmax 253 chars

portintegermin 1max 65535

security"tls" | "starttls"

usernamestringmax 200 chars

passwordstringpovinnémax 500 chars

readFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

providernull | stringpovinné

emailnull | stringpovinné

labelstring | nullpovinné

hostnull | stringpovinné

portinteger | nullpovinné

securitynull | stringpovinné

usernamenull | stringpovinné

foldernull | stringpovinné

statusstringpovinné

errorCodenull | stringpovinné

lastSyncAtnull | stringpovinnédate-time

readFromstringpovinnédate

createdAtstringpovinnédate-time

foldersstring[]

keepMessagesboolean

smtpHostnull | string

smtpPortinteger | null

smtpSecuritynull | string

smtpUsernamestring | null

sendingReadyboolean

POST/v1/mailboxes

curl -X POST https://api.damedoklad.cz/v1/mailboxes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "info@example.cz",
  "host": "string",
  "password": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/mailboxes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "email": "info@example.cz",
        "host": "string",
        "password": "string"
    },
)
data = response.json()

Rename a mailbox, pause it, give it a new password, choose which server folders are read, whether message text is kept, and its outgoing SMTP server. A new password is tested first

PATCH/v1/mailboxes/{id}

Rename a mailbox, pause it, give it a new password, choose which server folders are read, whether message text is kept, and its outgoing SMTP server. A new password is tested first

Nástroj MCP: update-mailbox

Parametry v cestě

idstringpovinné

Tělo požadavku

labelstring | null

passwordstringmax 500 chars

activeboolean

foldersstring[]

keepMessagesboolean

smtpHoststring | null

smtpPortinteger | null

smtpSecurity"tls" | "starttls" | null

smtpUsernamestring | null

Odpověď · 200

idstringpovinné

providernull | stringpovinné

emailnull | stringpovinné

labelstring | nullpovinné

hostnull | stringpovinné

portinteger | nullpovinné

securitynull | stringpovinné

usernamenull | stringpovinné

foldernull | stringpovinné

statusstringpovinné

errorCodenull | stringpovinné

lastSyncAtnull | stringpovinnédate-time

readFromstringpovinnédate

createdAtstringpovinnédate-time

foldersstring[]

keepMessagesboolean

smtpHostnull | string

smtpPortinteger | null

smtpSecuritynull | string

smtpUsernamestring | null

sendingReadyboolean

PATCH/v1/mailboxes/{id}

curl -X PATCH https://api.damedoklad.cz/v1/mailboxes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "string",
  "password": "string",
  "active": false
}'

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/mailboxes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "label": "string",
        "password": "string",
        "active": False
    },
)
data = response.json()

Disconnect a mailbox and forget its password or token. Documents already in K vyřízení stay, and nothing on the mail server changes

DELETE/v1/mailboxes/{id}

Disconnect a mailbox and forget its password or token. Documents already in K vyřízení stay, and nothing on the mail server changes

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

Nástroj MCP: remove-mailbox

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/mailboxes/{id}

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

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

List the folders on the mail server of a mailbox, to choose which are read. Asks the server, and changes nothing on it

GET/v1/mailboxes/{id}/folders

List the folders on the mail server of a mailbox, to choose which are read. Asks the server, and changes nothing on it

Nástroj MCP: list-mailbox-folders

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

pathnull | stringpovinné

namenull | stringpovinné

specialUsestringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/mailboxes/{id}/folders

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

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

Read a mailbox now instead of waiting for the next run. Says how many documents came, were refused, or were already there

POST/v1/mailboxes/{id}/sync

Read a mailbox now instead of waiting for the next run. Says how many documents came, were refused, or were already there

Nástroj MCP: sync-mailbox

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

statusstringpovinné

errorCodenull | string

receivedintegerpovinné

rejectedintegerpovinné

duplicatesintegerpovinné

skippedintegerpovinné

remaininginteger | nullpovinné

unreadableFoldersstring[]

POST/v1/mailboxes/{id}/sync

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

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

Suggest the IMAP server for an e-mail address. A suggestion only: connecting proves it

POST/v1/mailboxes/detect

Suggest the IMAP server for an e-mail address. A suggestion only: connecting proves it

Nástroj MCP: detect-mailbox-server

Tělo požadavku

emailstringpovinnéemail

Odpověď · 200

emailnull | stringpovinné

hostnull | stringpovinné

portinteger | nullpovinné

securitynull | stringpovinné

usernamenull | stringpovinné

knownbooleanpovinné

suggestedProviderstringpovinné

smtpHostnull | string

smtpPortinteger | null

smtpSecuritynull | string

POST/v1/mailboxes/detect

curl -X POST https://api.damedoklad.cz/v1/mailboxes/detect \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "info@example.cz"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/mailboxes/detect",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "email": "info@example.cz"
    },
)
data = response.json()

List the mail of connected mailboxes, newest first: status unprocessed or done, direction in or out, one mailbox, or a search in sender, subject and text

GET/v1/mailboxes/messages

List the mail of connected mailboxes, newest first: status unprocessed or done, direction in or out, one mailbox, or a search in sender, subject and text

Nástroj MCP: list-mailbox-messages

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"unprocessed" | "done"

direction"in" | "out"

mailboxIdstring

ID of the mailbox. Find it with list-mailboxes.

Odpověď · 200

dataobject[]povinné

object"mailbox_message"povinné

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/mailboxes/messages

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

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

Write a new message from a connected mailbox, through its own SMTP server. It really goes out. Off until the operator switches sending on

POST/v1/mailboxes/messages

Write a new message from a connected mailbox, through its own SMTP server. It really goes out. Off until the operator switches sending on. Attachments in fileBase64, up to 25 MB together. The copy is kept here under direction=out. It is not added to the Sent folder on the mail server.

Nástroj MCP: send-mailbox-message

Tělo požadavku

mailboxIdstringpovinné

ID of the mailbox. Find it with list-mailboxes.

tostring[]povinné

ccstring[]

subjectstringpovinnémax 300 chars

textstringpovinnémax 200000 chars

attachmentsobject[]

filenamestringpovinnémax 255 chars

contentTypestringpovinnémax 120 chars

fileBase64stringpovinné

File content encoded as base64.

Odpověď · 201

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

POST/v1/mailboxes/messages

curl -X POST https://api.damedoklad.cz/v1/mailboxes/messages \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mailboxId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "to": [
    "2026-10-30"
  ],
  "subject": "string",
  "text": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/mailboxes/messages', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mailboxId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "to": [
      "2026-10-30"
    ],
    "subject": "string",
    "text": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/mailboxes/messages",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "mailboxId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "to": [
            "2026-10-30"
        ],
        "subject": "string",
        "text": "string"
    },
)
data = response.json()

Read one message with its text. The text is plain, never HTML, and an attachment that reached K vyřízení names its document

GET/v1/mailboxes/messages/{id}

Read one message with its text. The text is plain, never HTML, and an attachment that reached K vyřízení names its document

Nástroj MCP: get-mailbox-message

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

GET/v1/mailboxes/messages/{id}

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

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

Move a message between Unprocessed and Done. This happens here only: nothing changes on the mail server

PATCH/v1/mailboxes/messages/{id}

Move a message between Unprocessed and Done. This happens here only: nothing changes on the mail server

Nástroj MCP: update-mailbox-message

Parametry v cestě

idstringpovinné

Tělo požadavku

status"unprocessed" | "done"povinné

Odpověď · 200

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

PATCH/v1/mailboxes/messages/{id}

curl -X PATCH https://api.damedoklad.cz/v1/mailboxes/messages/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "unprocessed"
}'

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/mailboxes/messages/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "status": "unprocessed"
    },
)
data = response.json()

Delete a message from here. It stays on the mail server, and documents already in K vyřízení stay too. It does not come back, because reading has moved past it

DELETE/v1/mailboxes/messages/{id}

Delete a message from here. It stays on the mail server, and documents already in K vyřízení stay too. It does not come back, because reading has moved past it

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

Nástroj MCP: delete-mailbox-message

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/mailboxes/messages/{id}

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

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

Forward a message with the attachments held in K vyřízení. An attachment that did not reach it was not kept, so it does not go along. It really goes out

POST/v1/mailboxes/messages/{id}/forward

Forward a message with the attachments held in K vyřízení. An attachment that did not reach it was not kept, so it does not go along. It really goes out

Nástroj MCP: forward-mailbox-message

Parametry v cestě

idstringpovinné

Tělo požadavku

tostring[]povinné

ccstring[]

textstringmax 200000 chars

attachmentsobject[]

filenamestringpovinnémax 255 chars

contentTypestringpovinnémax 120 chars

fileBase64stringpovinné

File content encoded as base64.

Odpověď · 201

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

POST/v1/mailboxes/messages/{id}/forward

curl -X POST https://api.damedoklad.cz/v1/mailboxes/messages/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/forward \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "2026-10-30"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/mailboxes/messages/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/forward', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "to": [
      "2026-10-30"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/mailboxes/messages/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/forward",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "to": [
            "2026-10-30"
        ]
    },
)
data = response.json()

Reply to a message from the mailbox it came to, quoting it and keeping the thread, and move it to Done. replyAll adds the others. It really goes out

POST/v1/mailboxes/messages/{id}/reply

Reply to a message from the mailbox it came to, quoting it and keeping the thread, and move it to Done. replyAll adds the others. It really goes out

Nástroj MCP: reply-to-mailbox-message

Parametry v cestě

idstringpovinné

Tělo požadavku

replyAllboolean

textstringpovinnémax 200000 chars

attachmentsobject[]

filenamestringpovinnémax 255 chars

contentTypestringpovinnémax 120 chars

fileBase64stringpovinné

File content encoded as base64.

Odpověď · 201

idstringpovinné

mailboxIdnull | stringpovinné

mailboxEmailstringpovinné

foldernull | stringpovinné

directionstringpovinné

statusstringpovinné

fromAddressnull | stringpovinné

fromNamenull | stringpovinné

tostring[]povinné

ccstring[]povinné

subjectnull | stringpovinné

sentAtnull | stringpovinnédate-time

previewstringpovinné

suspiciousbooleanpovinné

attachmentsobject[]povinné

filenamenull | stringpovinné

documentIdnull | stringpovinné

replyToIdnull | stringpovinné

doneAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

textstring

replyTostring | null

messageIdnull | string

POST/v1/mailboxes/messages/{id}/reply

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

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

import os
import requests

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

Which kinds of mailbox can be connected here. IMAP always; Gmail and Microsoft 365 when the operator has registered an app

GET/v1/mailboxes/providers

Which kinds of mailbox can be connected here. IMAP always; Gmail and Microsoft 365 when the operator has registered an app

Nástroj MCP: get-mailbox-providers

Odpověď · 200

imapbooleanpovinné

gmailbooleanpovinné

microsoft365booleanpovinné

sendingboolean

GET/v1/mailboxes/providers

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

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

Seznam: členové

GET/v1/members

List the people with access to this company and their roles

Nástroj MCP: list-members

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"membership"povinné

idstringpovinné

rolestringpovinné

userIdnull | stringpovinné

workspaceIdstringpovinné

emailnull | string

namenull | string

totpEnabledboolean

lastUsedAtnull | stringdate-time

joinedAtstringdate-time

isCurrentUserbooleanpovinné

accessRoleIdnull | string

accessRoleNamestring

accessnull | object

agendasobjectpovinné

payrollstring

contactsstring

salesstring

purchasesstring

bankstring

cashstring

ledgerstring

taxstring

inventorystring

assetsstring

travelstring

agendasstring

reportsstring

inboxstring

administrationstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/members

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

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

Invite someone by e-mail. Sends a real e-mail; confirm the address and role with the user first.

POST/v1/members

Invite someone by e-mail. Sends a real e-mail; confirm the address and role with the user first.

Nástroj MCP: invite-member

Tělo požadavku

emailstringpovinnéemail

accessRoleIdstring

ID of the access role. Find it with list-access-roles.

Odpověď · 201

idstringpovinné

emailnull | stringpovinné

rolestringpovinné

accessRoleIdnull | string

expiresAtstringpovinnédate-time

expiredbooleanpovinné

createdAtstringpovinnédate-time

tokenstring

POST/v1/members

curl -X POST https://api.damedoklad.cz/v1/members \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "info@example.cz",
  "role": "owner"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/members",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "email": "info@example.cz",
        "role": "owner"
    },
)
data = response.json()

Change what someone may do in this company. The last owner cannot be demoted.

PATCH/v1/members/{id}

Change what someone may do in this company. The last owner cannot be demoted.

Nástroj MCP: update-member-role

Parametry v cestě

idstringpovinné

Tělo požadavku

accessRoleIdstring

ID of the access role. Find it with list-access-roles.

Odpověď · 200

idstringpovinné

rolestringpovinné

userIdnull | stringpovinné

workspaceIdstringpovinné

emailnull | string

namenull | string

totpEnabledboolean

lastUsedAtnull | stringdate-time

joinedAtstringdate-time

isCurrentUserbooleanpovinné

accessRoleIdnull | string

accessRoleNamestring

accessnull | object

agendasobjectpovinné

payrollstring

contactsstring

salesstring

purchasesstring

bankstring

cashstring

ledgerstring

taxstring

inventorystring

assetsstring

travelstring

agendasstring

reportsstring

inboxstring

administrationstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

PATCH/v1/members/{id}

curl -X PATCH https://api.damedoklad.cz/v1/members/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "owner"
}'

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

import os
import requests

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

Remove someone from this company, or leave it yourself. Their API keys here are revoked. The last owner cannot be removed.

DELETE/v1/members/{id}

Remove someone from this company, or leave it yourself. Their API keys here are revoked. The last owner cannot be removed.

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

Nástroj MCP: remove-member

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/members/{id}

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

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

What one person may do in this company: a fixed role written out as rights, or a custom role with its parent applied

GET/v1/members/{id}/access

What one person may do in this company: a fixed role written out as rights, or a custom role with its parent applied

Nástroj MCP: get-member-access

Parametry v cestě

idstringpovinné

Odpověď · 200

rolenull | objectpovinné

idstringpovinné

namenull | stringpovinné

fixedRolenull | stringpovinné

parentnull | objectpovinné

idstringpovinné

namenull | stringpovinné

agendasobject[]povinné

keystringpovinné

levelstringpovinné

inheritedbooleanpovinné

scopesobjectpovinné

warehousesarray | nullpovinné

idstringpovinné

namenull | stringpovinné

registersanypovinné

Null in every recorded response.

accountsanypovinné

Null in every recorded response.

seriesanypovinné

Null in every recorded response.

centersanypovinné

Null in every recorded response.

deniedobjectpovinné

formatsstring[]povinné

reportsobject[]povinné

keystringpovinné

csstringpovinné

enstringpovinné

fixedOnlystring[]povinné

membersstring[]povinné

GET/v1/members/{id}/access

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

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

Get the membership and role of whoever is calling, and for a custom role the agendas and limits it has

GET/v1/members/me

Get the membership and role of whoever is calling, and for a custom role the agendas and limits it has

Nástroj MCP: get-current-member

Odpověď · 200

idstringpovinné

rolestringpovinné

userIdnull | stringpovinné

workspaceIdstringpovinné

emailnull | string

namenull | string

totpEnabledboolean

lastUsedAtnull | stringdate-time

joinedAtstringdate-time

isCurrentUserbooleanpovinné

accessRoleIdnull | string

accessRoleNamestring

accessnull | object

agendasobjectpovinné

payrollstring

contactsstring

salesstring

purchasesstring

bankstring

cashstring

ledgerstring

taxstring

inventorystring

assetsstring

travelstring

agendasstring

reportsstring

inboxstring

administrationstring

scopesobjectpovinné

warehousesarray | nullpovinné

registersarray | nullpovinné

accountsarray | nullpovinné

seriesarray | nullpovinné

centersarray | null

GET/v1/members/me

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

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

Seznam: oznámení

GET/v1/notifications

List notifications for this company, newest first: tax and payroll deadlines coming up, overdue invoices, failed e-mails and webhooks, finished imports

Nástroj MCP: list-notifications

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

unread"true" | "false"

Odpověď · 200

dataobject[]povinné

object"notification"povinné

idstringpovinné

kindstringpovinné

severitystringpovinné

paramsobjectpovinné

countinteger

oldestDaysinteger

amountHalerinteger | null

overDeadlineinteger

daysLeftinteger

notAfterstringdate

periodstring

linkboolean

whatstring

labelnull | string

statusstring

credentialstring

filenamenull | string

autoMatchedinteger

subjectnull | string

recipientstring

resultnull | object

contactsintegerpovinné

contactsUpdatedintegerpovinné

duestring

unknowninteger

keystring

datestringdate

labelCsstring

labelEnstring

contactNamenull | string

dueOnnull | stringdate

sentinteger

failedinteger

skippedinteger

pathnull | stringpovinné

titleCsstringpovinné

titleEnstringpovinné

bodyCsnull | stringpovinné

bodyEnnull | stringpovinné

readbooleanpovinné

readAtnull | stringpovinnédate-time

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/notifications

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

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

Find contacts and documents (invoices, received invoices, proformas, advances to suppliers, credit notes, delivery notes) by name, number, IČO, DIČ or variable symbol, and by any custom field marked as searchable

GET/v1/search

Find contacts and documents (invoices, received invoices, proformas, advances to suppliers, credit notes, delivery notes) by name, number, IČO, DIČ or variable symbol, and by any custom field marked as searchable

Nástroj MCP: search

Parametry dotazu

qstringpovinnémax 100 chars

limitintegermin 1max 50

Odpověď · 200

dataobject[]povinné

idstringpovinné

titlenull | stringpovinné

subtitlestringpovinné

pathnull | stringpovinné

totalintegerpovinné

hasMorebooleanpovinné

GET/v1/search

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

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

Send a failed delivery again

POST/v1/webhook-deliveries/{id}/retry

Send a failed delivery again

Nástroj MCP: retry-webhook-delivery

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

endpointIdstringpovinné

eventIdstringpovinné

eventTypestringpovinné

statusstringpovinné

attemptsintegerpovinné

nextAttemptAtnull | stringpovinnédate-time

responseStatusinteger | nullpovinné

responseBodynull | stringpovinné

durationMsinteger | nullpovinné

errornull | stringpovinné

isTestbooleanpovinné

payloadanypovinné

createdAtstringpovinnédate-time

deliveredAtnull | stringpovinnédate-time

POST/v1/webhook-deliveries/{id}/retry

curl -X POST https://api.damedoklad.cz/v1/webhook-deliveries/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/retry \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

List the event types a webhook can subscribe to. Payloads are in the `webhooks` section of /openapi.json

GET/v1/webhook-events

List the event types a webhook can subscribe to. Payloads are in the `webhooks` section of /openapi.json

Nástroj MCP: list-webhook-events

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"webhook_event"povinné

idstringpovinné

modulestringpovinné

summarynull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/webhook-events

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

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

List webhook endpoints

GET/v1/webhooks

List webhook endpoints

Nástroj MCP: list-webhook-endpoints

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"webhook_endpoint"povinné

idstringpovinné

urlstringpovinné

descriptionnull | stringpovinné

eventsstring[]povinné

enabledbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

secretstring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/webhooks

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

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

Create a webhook endpoint. The signing secret is returned once.

POST/v1/webhooks

Create a webhook endpoint. The signing secret is returned once.

Nástroj MCP: create-webhook-endpoint

Tělo požadavku

urlstringpovinnémax 2000 charsuri

descriptionstring | null

eventsstring[]výchozí ["*"]

Odpověď · 201

idstringpovinné

urlstringpovinné

descriptionnull | stringpovinné

eventsstring[]povinné

enabledbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

secretstring

POST/v1/webhooks

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

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

import os
import requests

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

Get a webhook endpoint

GET/v1/webhooks/{id}

Get a webhook endpoint

Nástroj MCP: get-webhook-endpoint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

urlstringpovinné

descriptionnull | stringpovinné

eventsstring[]povinné

enabledbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

secretstring

GET/v1/webhooks/{id}

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

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

Update a webhook endpoint: URL, events, or pause it

PATCH/v1/webhooks/{id}

Update a webhook endpoint: URL, events, or pause it

Nástroj MCP: update-webhook-endpoint

Parametry v cestě

idstringpovinné

Tělo požadavku

urlstringmax 2000 charsuri

descriptionstring | null

eventsstring[]

enabledboolean

Odpověď · 200

idstringpovinné

urlstringpovinné

descriptionnull | stringpovinné

eventsstring[]povinné

enabledbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

secretstring

PATCH/v1/webhooks/{id}

curl -X PATCH https://api.damedoklad.cz/v1/webhooks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "string",
  "description": "Pečivo, říjen",
  "events": [
    "string"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/webhooks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "string",
    "description": "Pečivo, říjen",
    "events": [
      "string"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/webhooks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "url": "string",
        "description": "Pečivo, říjen",
        "events": [
            "string"
        ]
    },
)
data = response.json()

Delete a webhook endpoint and its delivery log

DELETE/v1/webhooks/{id}

Delete a webhook endpoint and its delivery log

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

Nástroj MCP: delete-webhook-endpoint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/webhooks/{id}

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

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

List delivery attempts of a webhook endpoint, newest first

GET/v1/webhooks/{id}/deliveries

List delivery attempts of a webhook endpoint, newest first

Nástroj MCP: list-webhook-deliveries

Parametry v cestě

idstringpovinné

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"pending" | "success" | "failed"

Odpověď · 200

dataobject[]povinné

object"webhook_delivery"povinné

idstringpovinné

endpointIdstringpovinné

eventIdstringpovinné

eventTypestringpovinné

statusstringpovinné

attemptsintegerpovinné

nextAttemptAtnull | stringpovinnédate-time

responseStatusinteger | nullpovinné

responseBodynull | stringpovinné

durationMsinteger | nullpovinné

errornull | stringpovinné

isTestbooleanpovinné

payloadanypovinné

createdAtstringpovinnédate-time

deliveredAtnull | stringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/webhooks/{id}/deliveries

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

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

Replace the signing secret. The new secret is returned once; the old one stops working immediately.

POST/v1/webhooks/{id}/rotate-secret

Replace the signing secret. The new secret is returned once; the old one stops working immediately.

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

Nástroj MCP: rotate-webhook-secret

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

urlstringpovinné

descriptionnull | stringpovinné

eventsstring[]povinné

enabledbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

secretstring

POST/v1/webhooks/{id}/rotate-secret

curl -X POST https://api.damedoklad.cz/v1/webhooks/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rotate-secret \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Send a signed test event to this endpoint now and return the result. Test events are not retried.

POST/v1/webhooks/{id}/test

Send a signed test event to this endpoint now and return the result. Test events are not retried.

Nástroj MCP: test-webhook-endpoint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

endpointIdstringpovinné

eventIdstringpovinné

eventTypestringpovinné

statusstringpovinné

attemptsintegerpovinné

nextAttemptAtnull | stringpovinnédate-time

responseStatusinteger | nullpovinné

responseBodynull | stringpovinné

durationMsinteger | nullpovinné

errornull | stringpovinné

isTestbooleanpovinné

payloadanypovinné

createdAtstringpovinnédate-time

deliveredAtnull | stringpovinnédate-time

POST/v1/webhooks/{id}/test

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

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