Skip to content

Operations in the VAT and taxes group.

Base URLhttps://api.damedoklad.cz/v1AuthenticationErrors and limitsConventions

List bad debt corrections, creditor (§ 46) and debtor (§ 74b)

GET/v1/tax/bad-debts

List bad debt corrections, creditor (§ 46) and debtor (§ 74b)

MCP tool: list-tax-bad-debts

Query parameters

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.

Response · 200

dataany[]required
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/bad-debts
curl https://api.damedoklad.cz/v1/tax/bad-debts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a bad debt correction once its § 46 or § 74b conditions hold; it enters the return for its date

POST/v1/tax/bad-debts

Record a bad debt correction once its § 46 or § 74b conditions hold; it enters the return for its date

MCP tool: create-tax-bad-debt

Request body

side"creditor" | "debtor"
kind"reduction" | "increase"
documentType"invoice" | "received_invoice"required
documentIdstringrequired
ID of the document.
correctionDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
unpaidHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRateintegerrequiredmin 0max 100
ground"a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "74b1" | "74b2" | "74b3" | "74b4"
factsobject
firstOrderOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
limitSuspendedboolean
legalGroundstringmax 200 chars
evidenceNumberstringmax 60 chars
notestringmax 2000 chars

Response · 201

idstringrequired
sidestringrequired
documentTypestringrequired
documentIdstringrequired
kindstringrequired
groundnull | stringrequired
factsobjectrequired
notRelatedboolean
debtorKnownboolean
didNotKnowUnpaidboolean
enforcementStoppedNoAssetsboolean
noOtherGroundboolean
twoWrittenNoticesboolean
insolvencyDecisionboolean
insolvencyClaimFiledboolean
firstOrderOnstring | nullrequired
limitSuspendedbooleanrequired
correctionDatestringrequireddate
unpaidHalerintegerrequired
vatRateintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
legalGroundnull | stringrequired
evidenceNumbernull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
POST/v1/tax/bad-debts
curl -X POST https://api.damedoklad.cz/v1/tax/bad-debts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "correctionDate": "2026-10-30",
  "unpaidHaler": 1210000,
  "vatRate": 21
}'

Delete a bad debt correction

DELETE/v1/tax/bad-debts/{id}

Delete a bad debt correction

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-tax-bad-debt

Path parameters

idstringrequired

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/tax/bad-debts/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/bad-debts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Check the § 46 or § 74b conditions for a correction without saving it, with the statute behind each condition

POST/v1/tax/bad-debts/check

Check the § 46 or § 74b conditions for a correction without saving it, with the statute behind each condition

MCP tool: check-tax-bad-debt

Request body

side"creditor" | "debtor"
kind"reduction" | "increase"
documentType"invoice" | "received_invoice"required
documentIdstringrequired
ID of the document.
correctionDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
unpaidHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRateintegerrequiredmin 0max 100
ground"a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "74b1" | "74b2" | "74b3" | "74b4"
factsobject
firstOrderOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
limitSuspendedboolean
legalGroundstringmax 200 chars
evidenceNumberstringmax 60 chars
notestringmax 2000 chars

Response · 200

allowedbooleanrequired
conditionsobject[]required
codenull | stringrequired
metbooleanrequired
sectionstringrequired
messagenull | stringrequired
latestDatenull | stringrequireddate
sidestringrequired
sectionstringrequired
deadlinestringdate
POST/v1/tax/bad-debts/check
curl -X POST https://api.damedoklad.cz/v1/tax/bad-debts/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "correctionDate": "2026-10-30",
  "unpaidHaler": 1210000,
  "vatRate": 21
}'

Received invoices past the deadline of § 74b odst. 3 whose deduction must be lowered

GET/v1/tax/bad-debts/debtor-due

Received invoices past the deadline of § 74b odst. 3 whose deduction must be lowered

MCP tool: list-tax-debtor-corrections

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_debtor_correction"required
idstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
actionstringrequired
dueDatenull | stringrequireddate
deadlinestringrequireddate
lastPayDaystringrequireddate
unpaidHalerintegerrequired
alreadyCorrectedHalerintegerrequired
vatRateintegerrequired
ratesobject[]required
vatRateintegerrequired
unpaidHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
correctionDatestringrequireddate
currencynull | stringrequired
lastDatestringdate
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/bad-debts/debtor-due
curl https://api.damedoklad.cz/v1/tax/bad-debts/debtor-due \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

The grounds of § 46 odst. 1 with the facts the user must confirm for each

GET/v1/tax/bad-debts/grounds

The grounds of § 46 odst. 1 with the facts the user must confirm for each

MCP tool: get-tax-bad-debt-grounds

Response · 200

commonstring[]required
groundsobject[]required
groundnull | stringrequired
sectionstringrequired
factsstring[]required
datestring
factLabelsobjectrequired
enforcementRunningstringrequired
enforcementStoppedNoAssetsstringrequired
insolvencyClaimFiledstringrequired
insolvencyDecisionstringrequired
probateFinishedstringrequired
proceedingRunningstringrequired
rightsExercisedstringrequired
otherClaimEnforcementEndedstringrequired
otherClaimEnforcementRunningstringrequired
twoWrittenNoticesstringrequired
noOtherGroundstringrequired
debtorKnownstringrequired
didNotKnowUnpaidstringrequired
notRelatedstringrequired
GET/v1/tax/bad-debts/grounds
curl https://api.damedoklad.cz/v1/tax/bad-debts/grounds \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Every tax deadline of a year for this taxpayer: VAT, OSS, income tax, overviews, road and property tax, advances, with their status

GET/v1/tax/calendar

Every tax deadline of a year for this taxpayer: VAT, OSS, income tax, overviews, road and property tax, advances, with their status

MCP tool: get-tax-calendar

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

yearintegerrequired
dataobject[]required
formstringrequired
periodKeystringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
statusstringrequired
daysLeftintegerrequired
overduebooleanrequired
keystringrequired
kindstringrequired
amountKcinteger | nullrequired
totalintegerrequired
hasMorebooleanrequired
GET/v1/tax/calendar
curl https://api.damedoklad.cz/v1/tax/calendar \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

All VAT, income and road tax deadlines for a year, moved to the next working day where needed

GET/v1/tax/deadlines

All VAT, income and road tax deadlines for a year, moved to the next working day where needed

MCP tool: list-tax-deadlines

Query parameters

yearintegerrequiredmin 2016max 2100
limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
formstringrequired
periodKeystringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
statusstringrequired
daysLeftintegerrequired
overduebooleanrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/deadlines
curl https://api.damedoklad.cz/v1/tax/deadlines \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List own VAT registrations in other EU states, with the rates entered for each

GET/v1/tax/eu-registrations

List own VAT registrations in other EU states, with the rates entered for each

MCP tool: list-eu-vat-registrations

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"eu_vat_registration"required
idstringrequired
countrynull | stringrequired
vatNumberstringrequired
validFromnull | stringrequireddate
validTonull | stringrequireddate
establishmentnull | stringrequired
basicRateinteger | nullrequired
reducedRateinteger | nullrequired
secondReducedRateinteger | nullrequired
currencynull | stringrequired
vatAccountstringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/eu-registrations
curl https://api.damedoklad.cz/v1/tax/eu-registrations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add a VAT registration in another EU state: number, dates, branch, and that state’s rates

POST/v1/tax/eu-registrations

Add a VAT registration in another EU state: number, dates, branch, and that state’s rates. A document then takes vatMode eu_registration: the buyer’s country picks the registration, and only the base reaches the Czech return, on ř. 26. Rates left out come from the Commission’s table on the first day, and the currency from the state.

MCP tool: create-eu-vat-registration

Request body

countrystringrequired2 chars
vatNumberstringrequiredmin 3 charsmax 20 chars
validFromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
validTostring | null
Date as YYYY-MM-DD.
establishmentstring | null
basicRatenumber | null
reducedRatenumber | null
secondReducedRatenumber | null
currencystring | null
ISO 4217 currency code, for example CZK or EUR.

Response · 201

idstringrequired
countrynull | stringrequired
vatNumberstringrequired
validFromnull | stringrequireddate
validTonull | stringrequireddate
establishmentnull | stringrequired
basicRateinteger | nullrequired
reducedRateinteger | nullrequired
secondReducedRateinteger | nullrequired
currencynull | stringrequired
vatAccountstringrequired
POST/v1/tax/eu-registrations
curl -X POST https://api.damedoklad.cz/v1/tax/eu-registrations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "string",
  "vatNumber": "string",
  "validFrom": "2026-10-30"
}'

Change a VAT registration in another EU state, for example its end date or rates

PATCH/v1/tax/eu-registrations/{id}

Change a VAT registration in another EU state, for example its end date or rates

MCP tool: update-eu-vat-registration

Path parameters

idstringrequired

Request body

countrystring2 chars
vatNumberstringmin 3 charsmax 20 chars
validFromstringYYYY-MM-DD
Date as YYYY-MM-DD.
validTostring | null
Date as YYYY-MM-DD.
establishmentstring | null
basicRatenumber | null
reducedRatenumber | null
secondReducedRatenumber | null
currencystring | null
ISO 4217 currency code, for example CZK or EUR.

Response · 200

idstringrequired
countrynull | stringrequired
vatNumberstringrequired
validFromnull | stringrequireddate
validTonull | stringrequireddate
establishmentnull | stringrequired
basicRateinteger | nullrequired
reducedRateinteger | nullrequired
secondReducedRateinteger | nullrequired
currencynull | stringrequired
vatAccountstringrequired
PATCH/v1/tax/eu-registrations/{id}
curl -X PATCH https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "string",
  "vatNumber": "string",
  "validFrom": "2026-10-30"
}'

Delete a VAT registration no document uses yet. One already used is ended with a date instead

DELETE/v1/tax/eu-registrations/{id}

Delete a VAT registration no document uses yet. One already used is ended with a date instead

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-eu-vat-registration

Path parameters

idstringrequired

Response · 200

idstringrequired
countrynull | stringrequired
vatNumberstringrequired
validFromnull | stringrequireddate
validTonull | stringrequireddate
establishmentnull | stringrequired
basicRateinteger | nullrequired
reducedRateinteger | nullrequired
secondReducedRateinteger | nullrequired
currencynull | stringrequired
vatAccountstringrequired
DELETE/v1/tax/eu-registrations/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Which registration a buyer’s state picks on a date, with the currency a document under it takes

GET/v1/tax/eu-registrations/for-contact

Which registration a buyer’s state picks on a date, with the currency a document under it takes

MCP tool: get-eu-registration-for-contact

Query parameters

contactIdstringrequired
ID of the contact. Find it with list-contacts.
datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

countrynull | stringrequired
registeredbooleanrequired
currencynull | stringrequired
GET/v1/tax/eu-registrations/for-contact
curl https://api.damedoklad.cz/v1/tax/eu-registrations/for-contact \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

A member state’s VAT rates and currency on a date, from the Commission’s table that OSS uses. The state’s own website decides

GET/v1/tax/eu-registrations/rates

A member state’s VAT rates and currency on a date, from the Commission’s table that OSS uses. The state’s own website decides

MCP tool: get-eu-vat-rates

Query parameters

countrystringrequired2 chars
datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

countrynull | stringrequired
datestringrequireddate
currencynull | stringrequired
knownbooleanrequired
standardintegerrequired
reducedinteger[]required
GET/v1/tax/eu-registrations/rates
curl https://api.damedoklad.cz/v1/tax/eu-registrations/rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Base and VAT per state and rate for a period, as a working paper for the return filed in that state

GET/v1/tax/eu-registrations/summary

Base and VAT per state and rate for a period, as a working paper for the return filed in that state

MCP tool: get-eu-vat-summary

Query parameters

fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

fromstringrequireddate
tostringrequireddate
rowsobject[]required
countrynull | stringrequired
currencynull | stringrequired
rateintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
documentCountintegerrequired
GET/v1/tax/eu-registrations/summary
curl https://api.damedoklad.cz/v1/tax/eu-registrations/summary \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List tax filings, newest first, with their status

GET/v1/tax/filings

List tax filings, newest first, with their status

MCP tool: list-tax-filings

Query parameters

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.
form"DPHDP3" | "DPHKH1" | "DPHSHV" | "DPFDP7" | "DPPDP9" | "DSLDP3" | "OSSEI1" | "OSSNI1" | "OSSII1" | "SMEHL1" | "SMEOZ1" | "DNEDP6" | "OSVCSS" | "OSVCZP"
yearintegermin -9007199254740991max 9007199254740991

Response · 200

dataobject[]required
object"tax_filing"required
idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
certificatesobject[]
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
A2object[]required
A3any[]required
A4object[]required
A5objectrequired
B1any[]required
B2object[]required
B3objectrequired
Cobjectrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
tableBnull | object
tableCobject
tableFobject
tableGinteger
tableHnull | object
tableInull | object
tableJany
Null in every recorded response.
tableKobject
lossesobject[]required
remainingLossKcintegerrequired
issuesobject[]required
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
inputsobjectrequired
regimestring
flatRatePercentinteger | null
attachment1object
attachment2null | object
attachment3null | object
attachment4null | object
foreignCertificatesobject[]
spouseobject
childrenobject[]
employersobject[]
bonusobject
spouseDetailsobject
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
liabilitiesobject[]required
incomeobject[]required
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
mainStartobjectrequired
sideobjectrequired
healthobjectrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
mainStartobjectrequired
sideobjectrequired
healthobjectrequired
computedobject
yearintegerrequired
landobject[]
buildingsobject[]
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
returnDuestringdate
rowsobject[]
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
issuesobject[]required
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/filings
curl https://api.damedoklad.cz/v1/tax/filings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Start a draft filing for a form and period; the figures stay live until it is finalized

POST/v1/tax/filings

Start a draft filing for a form and period; the figures stay live until it is finalized

MCP tool: create-tax-filing

Request body

form"DPHDP3" | "DPHKH1" | "DPHSHV" | "DPFDP7" | "DPPDP9" | "DSLDP3" | "OSSEI1" | "OSSNI1" | "OSSII1" | "SMEHL1" | "SMEOZ1" | "DNEDP6" | "OSVCSS" | "OSVCZP"required
yearintegerrequiredmin 2016max 2100
monthintegermin 1max 12
quarterintegermin 1max 4
kind"regular" | "corrective" | "additional" | "additional_corrective" | "followup" | "followup_corrective"
discoveredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
nextPeriodCode"Q" | "M"
callNumberstringmax 32 chars
notestringmax 2000 chars
inputsobject

Response · 201

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
POST/v1/tax/filings
curl -X POST https://api.damedoklad.cz/v1/tax/filings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "form": "DPHDP3",
  "year": 2026
}'

A filing with its figures, problems and audit trail; a locked filing shows its snapshot and whether books changed since

GET/v1/tax/filings/{id}

A filing with its figures, problems and audit trail; a locked filing shows its snapshot and whether books changed since

MCP tool: get-tax-filing

Path parameters

idstringrequired

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
GET/v1/tax/filings/{id}
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Change a draft filing’s details such as discovery date, next period code or notes

PATCH/v1/tax/filings/{id}

Change a draft filing’s details such as discovery date, next period code or notes

MCP tool: update-tax-filing

Path parameters

idstringrequired

Request body

discoveredOnstring | null
Date as YYYY-MM-DD.
nextPeriodCode"Q" | "M" | null
callNumberstring | null
notestring | null
inputsobject

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
PATCH/v1/tax/filings/{id}
curl -X PATCH https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "discoveredOn": "2026-10-30",
  "nextPeriodCode": "Q",
  "callNumber": "string"
}'

Delete a draft filing. Locked and filed filings cannot be deleted

DELETE/v1/tax/filings/{id}

Delete a draft filing. Locked and filed filings cannot be deleted

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-tax-filing

Path parameters

idstringrequired

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/tax/filings/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record that a finalized filing was submitted, with the date and reference

POST/v1/tax/filings/{id}/filed

Record that a finalized filing was submitted, with the date and reference

MCP tool: mark-tax-filing-filed

Path parameters

idstringrequired

Request body

filedOnstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
referencestringmax 100 chars

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
POST/v1/tax/filings/{id}/filed
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filed \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "filedOn": "2026-10-30"
}'

Lock a draft: store a snapshot and the exact XML. Later changes in the books never alter it

POST/v1/tax/filings/{id}/finalize

Lock a draft: store a snapshot and the exact XML. Later changes in the books never alter it

MCP tool: finalize-tax-filing

Path parameters

idstringrequired

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
POST/v1/tax/filings/{id}/finalize
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/finalize \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Override one VAT return row in a draft (or clear it with null); the reason is kept in the audit trail

POST/v1/tax/filings/{id}/overrides

Override one VAT return row in a draft (or clear it with null); the reason is kept in the audit trail

MCP tool: override-tax-filing-row

Path parameters

idstringrequired

Request body

fieldstringrequired
valueinteger | nullrequired
reasonstringrequiredmin 3 charsmax 500 chars

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
POST/v1/tax/filings/{id}/overrides
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/overrides \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "field": "string",
  "value": -9007199254740991,
  "reason": "string"
}'

Download a working PDF copy of a filing; drafts are marked by their status

GET/v1/tax/filings/{id}/pdf

Download a working PDF copy of a filing; drafts are marked by their status

MCP tool: download-tax-filing-pdf

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

GET/v1/tax/filings/{id}/pdf
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Unlock a finalized filing that has not been filed; the old snapshot is dropped and the step is audited

POST/v1/tax/filings/{id}/reopen

Unlock a finalized filing that has not been filed; the old snapshot is dropped and the step is audited

MCP tool: reopen-tax-filing

Path parameters

idstringrequired

Request body

reasonstringrequiredmin 3 charsmax 500 chars

Response · 200

idstringrequired
formstringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
kindstringrequired
statusstringrequired
discoveredOnnull | stringrequireddate
nextPeriodCodestring | nullrequired
callNumberstring | nullrequired
overridesobjectrequired
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
advancesPaidKcinteger
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
substringrequired
letterstringrequired
sectionstringrequired
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
eurRateinteger
schemeNumberstring
internalNumberstring
additionalReasonsstring
osszCodestring
birthDatenull | stringdate
mainMonthsinteger
sideMonthsinteger
birthNumberstring
overpaymentToAdvancesboolean
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateDatestringdate
lossesobject[]
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
usedNowKcintegerrequired
usedPriorKcintegerrequired
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
statesobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
taxCreditsobject
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
turnoverKcinteger
researchClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
educationClaimsobject[]
tostringrequireddate
fromstringrequireddate
claimKcintegerrequired
usedNowKcintegerrequired
employeesAverageinteger
otherAdditionsKcinteger
businessobject
cooperatingobject[]required
dicnull | stringrequired
lastNamenull | stringrequired
relationstringrequired
sharePctintegerrequired
firstNamenull | stringrequired
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
rowstringrequired
textstringrequired
separateBaseIncomesobject[]
kindstringrequired
countrynull | stringrequired
incomeKcintegerrequired
descriptionnull | stringrequired
foreignTaxKcinteger
acquisitionCostKcinteger
otherDeductionsKcinteger
taxReturnDutyboolean
variableSymbolnull | string
nextSideboolean
flatTaxReasonstring
sideReason_zamboolean
cooperatingCitystring
cooperatingLastNamestring
filedElectronicallyboolean
cooperatingBirthDatestringdate
cooperatingFirstNamestring
cooperatingPostalCodestring
cooperatingBirthNumberstring
cooperatingHouseNumberstring
foreignobject
creditsobject[]required
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
certificatesobject[]
taxKcintegerrequired
countrynull | stringrequired
incomeKcintegerrequired
taxLocalintegerrequired
authoritystringrequired
publicationobject
emailnull | stringrequired
notesboolean
equityChangesboolean
statementFilesstring[]
rentalobject
flatbooleanrequired
incomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
firstNamenull | stringrequired
childUnder3booleanrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
otherIncomeobject[]
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
descriptionnull | stringrequired
separateBaseobject
capitalIncomeKcintegerrequired
bonusEligibleboolean
previousIdnull | stringrequired
finalizedAtnull | stringrequireddate-time
filedOnnull | stringrequireddate
filedReferencenull | stringrequired
notestring | nullrequired
createdAtstringrequireddate-time
updatedAtstringrequireddate-time
computedobject
formstringrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
subjectnull | objectrequired
oidstring
workspaceOidstring
subjectTypestringrequired
firstNamenull | string
lastNamenull | string
titlestring | null
financeOfficeCodenull | string
workplaceCodenull | string
naceCodenull | string
streetnull | string
houseNumbernull | string
orientationNumberstring | null
citynull | string
postalCodenull | string
countrystring | null
phonenull | string
emailnull | string
contactFirstNamestring | null
contactLastNamestring | null
contactPhonestring | null
signerFirstNamenull | string
signerLastNamenull | string
signerRolenull | string
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean
createdAtstringdate-time
updatedAtstringdate-time
namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
rowsarray | object
countrynull | stringrequired
vatIdstring
codeinteger | null
countinteger
valueHalerinteger | null
contactNamenull | string
valueinteger
stornoboolean
rateinteger
rateTypestring
supplyTypestring
baseCentsinteger
vatCentsinteger
sectornull | string
centsinteger
identifiedPersonboolean
cumulativeRowsobject
attachmentsobject[]
sectionstringrequired
titlenull | stringrequired
linesstring[]required
rowstring
adjustmentDetailsobject[]
idstringrequired
kindstringrequired
rowintegerrequired
valuesobjectrequired
baseinteger
fullinteger
deductibleinteger
valueinteger
notenull | stringrequired
sourcestringrequired
settlementnull | object
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
entriesCountinteger
issuesobject[]required
severitystringrequired
codenull | stringrequired
messagenull | stringrequired
documentIdnull | string
numbernull | string
statementobject
A1object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
codenull | stringrequired
baseHalerinteger | nullrequired
A2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
countrynull | stringrequired
vatIdstringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
base1integerrequired
vat1integerrequired
A3any[]required
A4object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
regimeintegerrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
A5objectrequired
base1integer
vat1integer
base2integer
vat2integer
B1any[]required
B2object[]required
documentIdnull | stringrequired
numbernull | stringrequired
contactNamenull | stringrequired
dicnull | stringrequired
evidenceNumbernull | stringrequired
datestringrequireddate
proportionalstringrequired
badDebtstringrequired
base1integerrequired
vat1integerrequired
base2integer
vat2integer
B3objectrequired
base1integer
vat1integer
Cobjectrequired
obrat23integerrequired
obrat5integerrequired
pln23integerrequired
pln5integerrequired
plnRezPrenintegerrequired
rezPren23integerrequired
rezPren5integerrequired
celkZdA2integerrequired
emptyboolean
allRowsobject[]
countrynull | stringrequired
vatIdstringrequired
codeinteger | nullrequired
countintegerrequired
valueHalerinteger | nullrequired
contactNamenull | stringrequired
valueintegerrequired
worksheetobject
yearintegerrequired
rowsobjectrequired
annex2any
Null in every recorded response.
annex3any
Null in every recorded response.
cfcCreditany
Null in every recorded response.
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
2integerrequired
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchobject[]required
educationobject[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHnull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
disabledEmployeesnumberrequired
severelyDisabledEmployeesnumberrequired
tableInull | object
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
row320integerrequired
statesobject[]required
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageinteger | nullrequired
currencynull | stringrequired
lossesobject[]required
tostringrequireddate
fromstringrequireddate
lossKcintegerrequired
lossYearintegerrequired
usedNowKcintegerrequired
remainingKcintegerrequired
usedPriorKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
linksobjectrequired
previousLossesany[]required
allowancesobjectrequired
transitionobjectrequired
depreciationDifferenceKcinteger
tableCobject
inputsobjectrequired
wageTaxPaidKcinteger
employmentIncomeKcinteger
lossesobject[]
giftsKcinteger
accountingCategorystring
tableCobject
foreignTaxobject
taxCreditsobject
turnoverKcinteger
researchClaimsobject[]
educationClaimsobject[]
employeesAverageinteger
otherAdditionsKcinteger
businessobject
flatRatePercentinteger
otherIncreaseKcinteger
specialAttachmentsobject[]
separateBaseIncomesobject[]
otherDeductionsKcinteger
additionalReasonsstring
foreignobject
publicationobject
statementFilesstring[]
rentalobject
spouseboolean | object
childrenobject[]
employersobject[]
otherIncomeobject[]
separateBaseobject
bonusEligibleboolean
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingobject[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
otherobjectrequired
rentalobjectrequired
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
attachment4null | object
foreignCertificatesobject[]
authoritystringrequired
countrynull | stringrequired
taxLocalintegerrequired
taxKcintegerrequired
incomeKcintegerrequired
estimatedbooleanrequired
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
lastNamenull | string
birthDatenull | stringdate
firstNamenull | string
childUnder3boolean
statementsNeededboolean
publicBenefitany
Null in every recorded response.
separateBasenull | object
331integerrequired
332integerrequired
333integerrequired
334integerrequired
335integerrequired
itemsobject[]required
sourceobject
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
previousnull | object
taxKcintegerrequired
lossKcintegerrequired
statementsnull | object
assetsobject[]required
c_radkuintegerrequired
kc_bruttointegerrequired
kc_korekceinteger | nullrequired
kc_nettointegerrequired
kc_netto_mininteger | nullrequired
liabilitiesobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
incomeobject[]required
c_radkuintegerrequired
kc_sledinteger | nullrequired
kc_mininteger | nullrequired
asOfstringrequireddate
rangestringrequired
beforeTaxKcintegerrequired
correctionsobject[]
yearintegerrequired
countrynull | stringrequired
quarterinteger | nullrequired
correctionCentsintegerrequired
eurRateinteger | null
eurRateDatenull | stringdate
schemestring
schemeNumbernull | string
intermediaryNumberany
Null in every recorded response.
internalNumberstring
totalVatCentsinteger
totalDueCentsinteger
bankobject
ibanstring | nullrequired
accountNamestringrequired
overviewobject
yearintegerrequired
rowsobjectrequired
participatesSideboolean
decisiveAmountKcinteger | null
balanceKcintegerrequired
nextAdvanceKcinteger | nullrequired
nextYearintegerrequired
issuesany[]required
taxBaseobject
taxBaseKcintegerrequired
sourcestringrequired
filingIdnull | stringrequired
statusnull | stringrequired
deadlinesobject
taxDuestringrequireddate
overviewobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
balanceDuestringrequireddate
minimumobject
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
minimumNextnull | object
yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
computedobject
yearintegerrequired
landobject[]
typestringrequired
areaM2integerrequired
ratePerM2number
coefficientinteger | null
parcelNumberintegerrequired
inflationintegerrequired
computedobjectrequired
cadastralCodeinteger
municipalityCodeinteger
pricePerM2integer
exemptAreaM2integer
exemptionsobject[]
buildingsobject[]
typestringrequired
areaM2integerrequired
ratePerM2numberrequired
houseNumberinteger | nullrequired
parcelNumberintegerrequired
cadastralCodeintegerrequired
businessAreaM2integerrequired
municipalityCodeintegerrequired
inflationintegerrequired
computedobjectrequired
landTaxinteger
buildingTaxinteger
totalintegerrequired
paymentsobject[]
duestringrequireddate
amountKcintegerrequired
returnDuestringdate
rowsobject[]
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
payableinteger
reasonsany
Null in every recorded response.
noticeobject
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
totalCentsintegerrequired
limitobject
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
evidenceNumbernull | string
exceededOnnull | stringdate
totalCentsinteger
duestringdate
publicationnull | object
pr11_rozvstringrequired
pr11_vzzstringrequired
pr11_puzstringrequired
pr11_pzvkstringrequired
pr11_pptstringrequired
pr11_uzmusstringrequired
pr11_emailstringrequired
xmlIssuesobject[]
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lockedAtnull | stringdate-time
lockedboolean
changedSinceLockboolean
eventsobject[]
object"tax_filing_event"required
idstringrequired
actionstringrequired
fieldnull | stringrequired
oldValuenull | stringrequired
newValuenull | stringrequired
reasonnull | stringrequired
actorIdnull | stringrequired
createdAtstringrequireddate-time
rowLabelsobject
POST/v1/tax/filings/{id}/reopen
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

Download a finalized filing as EPO XML for the Finanční správa

GET/v1/tax/filings/{id}/xml

Download a finalized filing as EPO XML for the Finanční správa

MCP tool: download-tax-filing-xml

Path parameters

idstringrequired

Response · 200

Returns a application/xml file.

GET/v1/tax/filings/{id}/xml
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Income tax worksheet for a year from the books: DPFO from the cash book or DPPO from the journal, plus deadlines and advances

GET/v1/tax/income

Income tax worksheet for a year from the books: DPFO from the cash book or DPPO from the journal, plus deadlines and advances

MCP tool: get-income-tax-worksheet

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

formstringrequired
yearintegerrequired
filingIdnull | stringrequired
filingStatusnull | string
worksheetobjectrequired
yearintegerrequired
rowsobjectrequired
annex2null | object
271integerrequired
272integerrequired
273integerrequired
274integerrequired
282integerrequired
284integerrequired
286integerrequired
288integerrequired
290integerrequired
periodsobject[]required
tostringrequireddate
fromstringrequireddate
daysintegerrequired
annex3null | object
aobjectrequired
bobjectrequired
totalAintegerrequired
totalBintegerrequired
tableIanyrequired
Null in every recorded response.
tableIIanyrequired
Null in every recorded response.
tableIIIobjectrequired
rowsobjectrequired
priceKcintegerrequired
expenseKcintegerrequired
differenceKcintegerrequired
companiesany[]required
tableIVKcintegerrequired
tableVobjectrequired
1integerrequired
2integerrequired
claimsany[]required
cfcCreditnull | object
statesobject[]required
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
6integerrequired
7integerrequired
countrynull | stringrequired
r6integerrequired
r7integerrequired
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
1integer
2integer
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchany[]required
educationany[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHany
Null in every recorded response.
tableIany
Null in every recorded response.
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageanyrequired
Null in every recorded response.
currencynull | stringrequired
lossesobject[]required
fromstringrequireddate
tostringrequireddate
lossKcintegerrequired
usedPriorKcintegerrequired
usedNowKcintegerrequired
lossYearintegerrequired
remainingKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
relatedPartyAdvancesobject
increaseKcintegerrequired
decreaseKcintegerrequired
rowsobject[]required
publicBenefitobject
treatmentnull | stringrequired
activitiesobject[]required
outsideHalerintegerrequired
exemptHalerintegerrequired
costBackHalerintegerrequired
taxedHalerintegerrequired
filingRequiredbooleanrequired
issuesobject[]required
inputsobjectrequired
flatRatePercentinteger
fundPeriodsobject[]
tostringrequireddate
fromstringrequireddate
antiAvoidanceobject
hybridKcintegerrequired
transfersOtherobjectrequired
otherAdditionsKcinteger
cfcForeignTaxStatesobject[]
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
useAssetLinksboolean
useTransportFlatRateboolean
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
rentalobject
incomeKcintegerrequired
flatbooleanrequired
otherIncomeobject[]
kindstringrequired
descriptionnull | stringrequired
incomeKcintegerrequired
expensesKcintegerrequired
foreignobject
creditsobject[]required
separateBaseobject
capitalIncomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
childUnder3booleanrequired
firstNamenull | stringrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
childrenobject[]
orderintegerrequired
monthsinteger
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
employmentIncomeKcinteger
wageTaxPaidKcinteger
lossesobject[]
fromstringrequireddate
tostringrequireddate
lossKcintegerrequired
usedPriorKcintegerrequired
usedNowKcintegerrequired
giftsKcinteger
accountingCategorystring
bonusEligibleboolean
publicBenefitobject
enabledbooleanrequired
standardstring
activitiesobject[]
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingany[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
rentalobjectrequired
201integerrequired
202integerrequired
203integerrequired
204integerrequired
205integerrequired
206integerrequired
201aintegerrequired
flatbooleanrequired
otherobjectrequired
207integerrequired
208integerrequired
209integerrequired
itemsobject[]required
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
321integerrequired
322integerrequired
323integerrequired
324numberrequired
325numberrequired
326integerrequired
327integerrequired
countrynull | stringrequired
attachment4null | object
foreignCertificatesany[]
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
childUnder3boolean
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
statementsNeededboolean
publicBenefitnull | object
standardstringrequired
reductionKcintegerrequired
treatmentnull | stringrequired
activitiesobject[]required
namenull | stringrequired
economicbooleanrequired
subsidyHalerintegerrequired
giftHalerintegerrequired
membershipHalerintegerrequired
interestHalerintegerrequired
otherIncomeHalerintegerrequired
costHalerintegerrequired
outsideBasebooleanrequired
taxableIncomeHalerintegerrequired
costAllowedHalerintegerrequired
costDisallowedHalerintegerrequired
filingRequiredbooleanrequired
reductionLimitKcintegerrequired
savedTaxKcintegerrequired
useBystringrequireddate
separateBaseany
Null in every recorded response.
deadlinesobject
paperobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
electronicobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
adviserobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
advancePlanobject
frequencystringrequired
amountKcintegerrequired
datesobject[]required
statutorystringrequireddate
duestringrequireddate
basisKcintegerrequired
advancesobject[]
idstringrequired
taxYearintegerrequired
dueOnnull | stringrequireddate
amountKcintegerrequired
paidOnnull | stringrequireddate
GET/v1/tax/income
curl https://api.damedoklad.cz/v1/tax/income \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Save worksheet inputs for a year: flat expenses, reliefs, gifts, losses, other adjustments

PUT/v1/tax/income

Save worksheet inputs for a year: flat expenses, reliefs, gifts, losses, other adjustments

MCP tool: update-income-tax-inputs

Query parameters

yearintegerrequiredmin 2016max 2100

Request body

publicBenefitobject
enabledbooleanrequired
taxTreatment"general" | "all_income"
standard"general" | "research" | "none"
membershipExemptboolean
giftsExemptboolean
alwaysTaxablestring[]
withheldInterestKcintegermin 0max 9007199254740991
reductionKcinteger | null
priorUnusedSavingKcintegermin 0max 9007199254740991
activitiesobject[]
namestringrequiredmax 120 chars
economicboolean
subsidyKcintegermin 0max 9007199254740991
giftKcintegermin 0max 9007199254740991
membershipKcintegermin 0max 9007199254740991
interestKcintegermin 0max 9007199254740991
incomeKcintegermin 0max 9007199254740991
costKcintegermin 0max 9007199254740991
flatRatePercent80 | 60 | 40 | 30 | null
employmentIncomeKcintegermin 0max 9007199254740991
employersobject[]
namestringrequiredmax 255 chars
incomeKcintegerrequiredmin 0max 9007199254740991
advanceKcintegermin 0max 9007199254740991
bonusKcintegermin 0max 9007199254740991
foreignEmploymentTaxKcintegermin 0max 9007199254740991
capitalBaseKcintegermin -9007199254740991max 9007199254740991
rentalBaseKcintegermin -9007199254740991max 9007199254740991
otherBaseKcintegermin -9007199254740991max 9007199254740991
rentalobject | null
incomeKcintegerrequiredmin 0max 9007199254740991
realEstateKcintegermin 0max 9007199254740991
expensesKcintegermin 0max 9007199254740991
flatboolean
increaseKcintegermin 0max 9007199254740991
decreaseKcintegermin 0max 9007199254740991
otherIncomeobject[]
kind"A" | "B" | "C" | "D" | "E" | "F" | "G" | "H"required
descriptionstringmax 50 chars
incomeKcintegerrequiredmin 0max 9007199254740991
expensesKcintegermin 0max 9007199254740991
code"P" | "S" | "Z" | "N"
foreignobject | null
exemptEmploymentKcintegermin 0max 9007199254740991
exemptOtherKcintegermin 0max 9007199254740991
creditsobject[]
countrystringrequired2 chars
incomeKcintegerrequiredmin 0max 9007199254740991
expensesKcintegermin 0max 9007199254740991
taxPaidKcintegerrequiredmin 0max 9007199254740991
certificatesobject[]
authoritystringrequiredmax 255 chars
countrystringrequired2 chars
taxLocalintegermin 0max 9007199254740991
taxKcintegerrequiredmin 0max 9007199254740991
incomeKcintegerrequiredmin -9007199254740991max 9007199254740991
estimatedboolean
separateBaseobject | null
partnerIncomeKcintegermin 0max 9007199254740991
capitalIncomeKcintegermin 0max 9007199254740991
prizeIncomeKcintegermin 0max 9007199254740991
prizeExpensesKcintegermin 0max 9007199254740991
lotteryIncomeKcintegermin 0max 9007199254740991
lotteryExpensesKcintegermin 0max 9007199254740991
creditIncomeKcintegermin 0max 9007199254740991
creditTaxKcintegermin 0max 9007199254740991
businessobject | null
increaseKcintegermin 0max 9007199254740991
decreaseKcintegermin 0max 9007199254740991
monthsintegermin 0max 12
realEstateDepreciationKcintegermin 0max 9007199254740991
cooperatingobject[]
firstNamestringrequiredmax 36 chars
lastNamestringrequiredmax 36 chars
dicstringrequired
VAT number (DIČ), for example CZ12345678.
sharePctnumberrequiredmin 0max 100
monthsintegermin 1max 12
relation"spouse" | "household" | "family"required
receivedShareobject | null
firstNamestringrequiredmax 36 chars
lastNamestringrequiredmax 36 chars
dicstringrequired
VAT number (DIČ), for example CZ12345678.
sharePctnumbermin 0max 100
incomeKcintegerrequiredmin 0max 9007199254740991
expensesKcintegerrequiredmin 0max 9007199254740991
lossKcintegermin 0max 9007199254740991
lossesobject[]
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
periodstringmax 22 chars
lossKcintegerrequiredmin 0max 9007199254740991
usedPriorKcintegermin 0max 9007199254740991
usedNowKcintegerrequiredmin 0max 9007199254740991
icostring
Czech company number (IČO), 8 digits.
giftsKcintegermin 0max 9007199254740991
interestKcintegermin 0max 9007199254740991
pensionKcintegermin 0max 9007199254740991
lifeInsuranceKcintegermin 0max 9007199254740991
longTermProductKcintegermin 0max 9007199254740991
longTermCareKcintegermin 0max 9007199254740991
researchKcintegermin 0max 9007199254740991
educationKcintegermin 0max 9007199254740991
spouseboolean | object | null
disability12boolean | integer
disability3boolean | integer
ztppboolean | integer
childrenobject[]
orderintegerrequiredmin 1max 9007199254740991
monthsintegermin 0max 12
monthsZtppintegermin 0max 12
ztppboolean
firstNamestringmax 36 chars
lastNamestringmax 36 chars
birthNumberstring
birthDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
bonusEligibleboolean | null
wageTaxPaidKcintegermin 0max 9007199254740991
monthlyBonusPaidKcintegermin 0max 9007199254740991
unlawfulReductionsKcintegermin -9007199254740991max 9007199254740991
otherAdditionsKcintegermin -9007199254740991max 9007199254740991
depreciationDifferenceKcintegermin -9007199254740991max 9007199254740991
taxDepreciationExcessKcintegermin 0max 9007199254740991
otherIncreaseKcintegermin -9007199254740991max 9007199254740991
otherDeductionsKcintegermin -9007199254740991max 9007199254740991
creditsKcintegermin 0max 9007199254740991
tableCobject
researchClaimsobject[]
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
claimKcintegerrequiredmin 0max 9007199254740991
usedPriorKcintegermin 0max 9007199254740991
usedNowKcintegerrequiredmin 0max 9007199254740991
educationClaimsobject[]
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
claimKcintegerrequiredmin 0max 9007199254740991
usedPriorKcintegermin 0max 9007199254740991
usedNowKcintegerrequiredmin 0max 9007199254740991
taxCreditsobject | null
disabledEmployeesnumbermin 0
severelyDisabledEmployeesnumbermin 0
enforcementKcintegermin 0max 9007199254740991
investmentKcintegermin 0max 9007199254740991
foreignExemptKcintegermin -9007199254740991max 9007199254740991
foreignTaxobject | null
fullCreditKcintegermin 0max 9007199254740991
statesobject[]
countrystringrequired2 chars
taxPaidKcintegerrequiredmin 0max 9007199254740991
incomeKcintegerrequiredmin 0max 9007199254740991
expensesKcintegermin 0max 9007199254740991
limitedPartnershipobject | null
1object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
2object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
3object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
4object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
5object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
7object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
9object
generalKcintegermin -9007199254740991max 9007199254740991
limitedKcintegermin -9007199254740991max 9007199254740991
turnoverKcintegermin -9007199254740991max 9007199254740991
employeesAverageintegermin 0max 9007199254740991
fundPeriodsobject[]
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
antiAvoidanceobject | null
borrowingobject | null
priorIncreasesKcintegermin 0max 9007199254740991
priorDecreasesKcintegermin 0max 9007199254740991
excessKcintegermin -9007199254740991max 9007199254740991
taxEbitdaKcintegermin -9007199254740991max 9007199254740991
transfersTreatyobject | null
hmotobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
nehmobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
finobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
zasobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
pohlobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
ostobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
transfersOtherobject | null
hmotobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
nehmobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
finobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
zasobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
pohlobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
ostobject
priceKcintegermin 0max 9007199254740991
expenseKcintegermin 0max 9007199254740991
transferInIncreaseKcintegermin 0max 9007199254740991
transferInDecreaseKcintegermin 0max 9007199254740991
hybridKcintegermin 0max 9007199254740991
cfcCompaniesobject[]
namestringrequiredmax 255 chars
taxIdstringmax 20 chars
ID of the tax.
countrystringrequired2 chars
amountKcintegerrequiredmin 0max 9007199254740991
cfcClaimsobject[]
namestringrequiredmax 255 chars
taxIdstringmax 20 chars
ID of the tax.
countrystringrequired2 chars
rowsobject[]required
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
claimKcintegerrequiredmin 0max 9007199254740991
usedPriorKcintegermin 0max 9007199254740991
usedNowKcintegermin 0max 9007199254740991
cfcForeignTaxStatesobject[]
countrystringrequired2 chars
taxPaidKcintegerrequiredmin 0max 9007199254740991
incomeKcintegerrequiredmin 0max 9007199254740991
expensesKcintegermin 0max 9007199254740991
cfcFundTaxKcintegermin 0max 9007199254740991
separateBaseIncomesobject[]
descriptionstringrequiredmax 120 chars
countrystringrequired2 chars
kind"dividend" | "settlement"required
incomeKcintegerrequiredmin 0max 9007199254740991
acquisitionCostKcintegermin 0max 9007199254740991
foreignTaxKcintegermin 0max 9007199254740991
specialAttachmentsobject[]
rowstringrequired
textstringrequiredmax 4000 chars
publicationobject | null
emailstringrequiredmax 255 charsemail
balanceSheetboolean
incomeStatementboolean
notesboolean
cashFlowboolean
equityChangesboolean
statementFiles"notes" | "cashFlow" | "equityChanges"[]
investmentIncentiveobject | null
section"35a" | "35b"required
decisionNumberintegermin 0max 999
decisionPartintegermin 0max 9999
decisionDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
firstPeriodstringmax 30 chars
capKcintegermin 0max 9007199254740991
usedPriorKcintegermin 0max 9007199254740991
interestExcessKcintegermin 0max 9007199254740991
violationKcintegermin 0max 9007199254740991
startingS2Kcintegermin 0max 9007199254740991
indexPercentnumber
advancesPaidKcintegermin 0max 9007199254740991
useAssetLinksboolean
useTransportFlatRateboolean
statementStructure"full" | "short" | "micro"
accountingCategory"M" | "L" | "S" | "V" | null
additionalReasonsstringmax 4000 chars

Response · 200

formstringrequired
yearintegerrequired
filingIdnull | stringrequired
filingStatusnull | string
worksheetobjectrequired
yearintegerrequired
rowsobjectrequired
annex2null | object
271integerrequired
272integerrequired
273integerrequired
274integerrequired
282integerrequired
284integerrequired
286integerrequired
288integerrequired
290integerrequired
periodsobject[]required
tostringrequireddate
fromstringrequireddate
daysintegerrequired
annex3null | object
aobjectrequired
bobjectrequired
totalAintegerrequired
totalBintegerrequired
tableIanyrequired
Null in every recorded response.
tableIIanyrequired
Null in every recorded response.
tableIIIobjectrequired
rowsobjectrequired
priceKcintegerrequired
expenseKcintegerrequired
differenceKcintegerrequired
companiesany[]required
tableIVKcintegerrequired
tableVobjectrequired
1integerrequired
2integerrequired
claimsany[]required
cfcCreditnull | object
statesobject[]required
1integerrequired
2integerrequired
3integerrequired
4integerrequired
5integerrequired
6integerrequired
7integerrequired
countrynull | stringrequired
r6integerrequired
r7integerrequired
incentiveany
Null in every recorded response.
tableAobject[]
namenull | stringrequired
amountKcintegerrequired
tableBnull | object
1integer
2integer
totalintegerrequired
accountingKcintegerrequired
tableCobject
tableFobject
researchany[]required
educationany[]required
researchRemainingKcintegerrequired
educationRemainingKcintegerrequired
tableGinteger
tableHany
Null in every recorded response.
tableIany
Null in every recorded response.
tableJany
Null in every recorded response.
tableKobject
turnoverKcintegerrequired
employeesAverageanyrequired
Null in every recorded response.
currencynull | stringrequired
lossesobject[]required
fromstringrequireddate
tostringrequireddate
lossKcintegerrequired
usedPriorKcintegerrequired
usedNowKcintegerrequired
lossYearintegerrequired
remainingKcintegerrequired
remainingLossKcintegerrequired
issuesobject[]required
codenull | stringrequired
severitystringrequired
messagenull | stringrequired
lossKcinteger
taxKcintegerrequired
advancesPaidKcinteger
payableKcintegerrequired
lastKnownTaxKcintegerrequired
sourceobjectrequired
kindstringrequired
incomeKcintegerrequired
expensesKcintegerrequired
resultKcintegerrequired
nonDeductibleKcintegerrequired
exemptIncomeKcintegerrequired
nonDeductibleGroupsobject[]required
namenull | stringrequired
amountKcintegerrequired
linksobjectrequired
assetsobjectrequired
allowancesobjectrequired
transitionobjectrequired
transportKcintegerrequired
transportVehiclesintegerrequired
wagesKcintegerrequired
useAssetLinksbooleanrequired
useTransportFlatRatebooleanrequired
previousLossesany[]required
allowancesobjectrequired
addBackKcintegerrequired
releasedKcintegerrequired
transitionobjectrequired
increaseKcintegerrequired
decreaseKcintegerrequired
depreciationDifferenceKcinteger
tableCobject
relatedPartyAdvancesobject
increaseKcintegerrequired
decreaseKcintegerrequired
rowsobject[]required
publicBenefitobject
treatmentnull | stringrequired
activitiesobject[]required
outsideHalerintegerrequired
exemptHalerintegerrequired
costBackHalerintegerrequired
taxedHalerintegerrequired
filingRequiredbooleanrequired
issuesobject[]required
inputsobjectrequired
flatRatePercentinteger
fundPeriodsobject[]
tostringrequireddate
fromstringrequireddate
antiAvoidanceobject
hybridKcintegerrequired
transfersOtherobjectrequired
otherAdditionsKcinteger
cfcForeignTaxStatesobject[]
countrynull | stringrequired
incomeKcintegerrequired
taxPaidKcintegerrequired
expensesKcintegerrequired
useAssetLinksboolean
useTransportFlatRateboolean
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
rentalobject
incomeKcintegerrequired
flatbooleanrequired
otherIncomeobject[]
kindstringrequired
descriptionnull | stringrequired
incomeKcintegerrequired
expensesKcintegerrequired
foreignobject
creditsobject[]required
separateBaseobject
capitalIncomeKcintegerrequired
spouseboolean | object
monthsintegerrequired
incomeKcintegerrequired
childUnder3booleanrequired
firstNamenull | stringrequired
lastNamenull | stringrequired
birthDatenull | stringrequireddate
childrenobject[]
orderintegerrequired
monthsinteger
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
employmentIncomeKcinteger
wageTaxPaidKcinteger
lossesobject[]
fromstringrequireddate
tostringrequireddate
lossKcintegerrequired
usedPriorKcintegerrequired
usedNowKcintegerrequired
giftsKcinteger
accountingCategorystring
bonusEligibleboolean
publicBenefitobject
enabledbooleanrequired
standardstring
activitiesobject[]
regimestring
flatRatePercentinteger | null
attachment1object
monthsinteger | nullrequired
depreciationKcintegerrequired
realEstateDepreciationKcintegerrequired
wagesKcintegerrequired
cooperatingany[]required
receivedShareanyrequired
Null in every recorded response.
attachment2null | object
rentalobjectrequired
201integerrequired
202integerrequired
203integerrequired
204integerrequired
205integerrequired
206integerrequired
201aintegerrequired
flatbooleanrequired
otherobjectrequired
207integerrequired
208integerrequired
209integerrequired
itemsobject[]required
attachment3null | object
311anyrequired
Null in every recorded response.
312anyrequired
Null in every recorded response.
313anyrequired
Null in every recorded response.
314anyrequired
Null in every recorded response.
315anyrequired
Null in every recorded response.
316anyrequired
Null in every recorded response.
328integerrequired
329integerrequired
330integerrequired
statesobject[]required
321integerrequired
322integerrequired
323integerrequired
324numberrequired
325numberrequired
326integerrequired
327integerrequired
countrynull | stringrequired
attachment4null | object
foreignCertificatesany[]
spouseobject
monthsintegerrequired
monthsZtppintegerrequired
childrenobject[]
orderintegerrequired
monthsinteger
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
employersobject[]
namenull | stringrequired
incomeKcintegerrequired
advanceKcintegerrequired
bonusobject
wouldBeKcintegerrequired
thresholdKcintegerrequired
incomeKcintegerrequired
incomeTestMetbooleanrequired
confirmedboolean | nullrequired
spouseDetailsobject
monthsinteger
incomeKcinteger
childUnder3boolean
firstNamenull | string
lastNamenull | string
birthDatenull | stringdate
statementsNeededboolean
publicBenefitnull | object
standardstringrequired
reductionKcintegerrequired
treatmentnull | stringrequired
activitiesobject[]required
namenull | stringrequired
economicbooleanrequired
subsidyHalerintegerrequired
giftHalerintegerrequired
membershipHalerintegerrequired
interestHalerintegerrequired
otherIncomeHalerintegerrequired
costHalerintegerrequired
outsideBasebooleanrequired
taxableIncomeHalerintegerrequired
costAllowedHalerintegerrequired
costDisallowedHalerintegerrequired
filingRequiredbooleanrequired
reductionLimitKcintegerrequired
savedTaxKcintegerrequired
useBystringrequireddate
separateBaseany
Null in every recorded response.
deadlinesobject
paperobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
electronicobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
adviserobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
advancePlanobject
frequencystringrequired
amountKcintegerrequired
datesobject[]required
statutorystringrequireddate
duestringrequireddate
basisKcintegerrequired
advancesobject[]
idstringrequired
taxYearintegerrequired
dueOnnull | stringrequireddate
amountKcintegerrequired
paidOnnull | stringrequireddate
PUT/v1/tax/income
curl -X PUT https://api.damedoklad.cz/v1/tax/income \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "publicBenefit": {
    "enabled": false
  },
  "flatRatePercent": 80,
  "employmentIncomeKc": 0
}'

Create the advance payments (§ 38a) due after filing the given tax year, from its last known tax

POST/v1/tax/income/advances

Create the advance payments (§ 38a) due after filing the given tax year, from its last known tax

MCP tool: generate-income-advances

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

frequencystringrequired
amountKcintegerrequired
basisKcintegerrequired
datesobject[]required
statutorystringrequireddate
duestringrequireddate
POST/v1/tax/income/advances
curl -X POST https://api.damedoklad.cz/v1/tax/income/advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Mark an income tax advance as paid, which feeds the worksheet for its tax year

PATCH/v1/tax/income/advances/{id}

Mark an income tax advance as paid, which feeds the worksheet for its tax year

MCP tool: mark-income-advance

Path parameters

idstringrequired

Request body

paidOnstring | nullrequired
Date as YYYY-MM-DD.

Response · 200

idstringrequired
dueOnstringrequireddate
amountKcintegerrequired
paidOnnull | stringrequireddate
PATCH/v1/tax/income/advances/{id}
curl -X PATCH https://api.damedoklad.cz/v1/tax/income/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "paidOn": "2026-10-30"
}'

Separate record of supplies in the § 89 and § 90 margin schemes for a period: price, purchase, margin, base, and tax

GET/v1/tax/margin

Separate record of supplies in the § 89 and § 90 margin schemes for a period: price, purchase, margin, base, and tax

MCP tool: get-margin-report

Query parameters

fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

fromstringrequireddate
tostringrequireddate
rowsobject[]required
documentTypenull | stringrequired
documentIdnull | stringrequired
numbernull | stringrequired
taxPointDatenull | stringrequireddate
contactNamenull | stringrequired
vatModestringrequired
sectionstringrequired
grossHalerintegerrequired
purchaseHalerintegerrequired
marginHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
totalsobjectrequired
marginHalerintegerrequired
vatHalerinteger | nullrequired
GET/v1/tax/margin
curl https://api.damedoklad.cz/v1/tax/margin \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Purchase prices and margin per line of a document in a § 89 or § 90 margin scheme

GET/v1/tax/margin-documents/{id}

Purchase prices and margin per line of a document in a § 89 or § 90 margin scheme

MCP tool: get-margin-document

Path parameters

idstringrequired

Response · 200

documentTypenull | stringrequired
documentIdnull | stringrequired
numbernull | stringrequired
vatModestringrequired
statusstringrequired
completebooleanrequired
linesobject[]required
positioninteger | nullrequired
descriptionnull | stringrequired
vatRateintegerrequired
grossHalerintegerrequired
purchaseHalerinteger | nullrequired
exemptPercentintegerrequired
marginHalerinteger
baseHalerinteger | null
vatHalerinteger | null
outsideMarginHalerinteger
GET/v1/tax/margin-documents/{id}
curl https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Enter the purchase price per line of a draft in a margin scheme. Needed before it can be issued

PUT/v1/tax/margin-documents/{id}

Enter the purchase price per line of a draft in a margin scheme. Needed before it can be issued

MCP tool: set-margin-document-lines

Path parameters

idstringrequired

Request body

linesobject[]required
positionintegerrequiredmin 0max 9007199254740991
purchaseHalerintegerrequiredmin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
notestringmax 240 chars

Response · 200

documentTypenull | stringrequired
documentIdnull | stringrequired
numbernull | stringrequired
vatModestringrequired
statusstringrequired
completebooleanrequired
linesobject[]required
positioninteger | nullrequired
descriptionnull | stringrequired
vatRateintegerrequired
grossHalerintegerrequired
purchaseHalerinteger | nullrequired
exemptPercentintegerrequired
marginHalerinteger
baseHalerinteger | null
vatHalerinteger | null
outsideMarginHalerinteger
PUT/v1/tax/margin-documents/{id}
curl -X PUT https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "lines": [
    {
      "position": 0,
      "purchaseHaler": 1210000
    }
  ]
}'

Document on the sale of a vehicle to a person with a disability, stating the tax on the margin. § 85 ZDPH ended on 31. 12. 2024: only for a contribution decided before it (zákon 461/2024 Sb., bod 24)

POST/v1/tax/margin-documents/{id}/vehicle-sale

Document on the sale of a vehicle to a person with a disability, stating the tax on the margin. § 85 ZDPH ended on 31. 12. 2024: only for a contribution decided before it (zákon 461/2024 Sb., bod 24)

MCP tool: get-margin-vehicle-sale-pdf

Path parameters

idstringrequired

Request body

buyerNamestringrequiredmax 200 chars
buyerAddressstringrequiredmax 400 chars
decisionReferencestringrequiredmax 120 chars
decisionDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
vehicleIdentificationstringrequiredmax 64 chars

Response · 200

Returns a application/pdf file.

POST/v1/tax/margin-documents/{id}/vehicle-sale
curl -X POST https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/vehicle-sale \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "buyerName": "Pekárna U Lípy s.r.o.",
  "buyerAddress": "string",
  "decisionReference": "string",
  "decisionDate": "2026-10-30",
  "vehicleIdentification": "string"
}' \
  -o soubor

The coefficient of a travel service advance (§ 89 odst. 5 to 7) for one proforma, with the payments it taxed

GET/v1/tax/margin/advances/{id}

The coefficient of a travel service advance (§ 89 odst. 5 to 7) for one proforma, with the payments it taxed

MCP tool: get-margin-advance-plan

Path parameters

idstringrequired

Response · 200

proformaIdstringrequired
numbernull | stringrequired
totalHalerinteger | nullrequired
methodstringrequired
purchasesHalerintegerrequired
coefficientnull | numberrequired
paymentsany[]required
GET/v1/tax/margin/advances/{id}
curl https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Set how a proforma in the travel scheme taxes its advances: by what was already paid for the service (§ 89 odst. 5) or what is expected (odst. 6)

PUT/v1/tax/margin/advances/{id}

Set how a proforma in the travel scheme taxes its advances: by what was already paid for the service (§ 89 odst. 5) or what is expected (odst. 6)

MCP tool: set-margin-advance-plan

Path parameters

idstringrequired

Request body

method"paid" | "estimated"required
purchasesHalerintegerrequiredmin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
keepFirstCoefficientboolean

Response · 200

proformaIdstringrequired
numbernull | stringrequired
totalHalerinteger | nullrequired
methodstringrequired
purchasesHalerintegerrequired
coefficientnull | numberrequired
paymentsany[]required
PUT/v1/tax/margin/advances/{id}
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "paid",
  "purchasesHaler": 1210000
}'

Art, collectibles and antiques whose deduction waits for a sale outside the scheme (§ 90 odst. 15 and 16)

GET/v1/tax/margin/deferred

Art, collectibles and antiques whose deduction waits for a sale outside the scheme (§ 90 odst. 15 and 16)

MCP tool: list-margin-deferred-deductions

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_margin_deferred_deduction"required
idstringrequired
receivedInvoiceIdstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
vatHalerinteger | nullrequired
caseCodestringrequired
descriptionnull | stringrequired
statusstringrequired
saleDocumentIdnull | string
saleDocumentTypenull | string
claimedOnnull | stringdate
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/margin/deferred
curl https://api.damedoklad.cz/v1/tax/margin/deferred \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Hold back the deduction on a received invoice under § 90 odst. 15: it stays out of the return until the goods are sold outside the scheme

POST/v1/tax/margin/deferred

Hold back the deduction on a received invoice under § 90 odst. 15: it stays out of the return until the goods are sold outside the scheme

MCP tool: create-margin-deferred-deduction

Request body

receivedInvoiceIdstringrequired
ID of the received invoice. Find it with list-received-invoices.
caseCode"imported" | "author" | "other_taxable"required
descriptionstring | null

Response · 201

idstringrequired
receivedInvoiceIdstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
vatHalerinteger | nullrequired
caseCodestringrequired
descriptionnull | stringrequired
statusstringrequired
saleDocumentIdnull | string
saleDocumentTypenull | string
claimedOnnull | stringdate
POST/v1/tax/margin/deferred
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "caseCode": "imported"
}'

The goods were sold outside the scheme: the deduction arises when the tax on that sale is due (§ 90 odst. 16), and reaches that period’s return

POST/v1/tax/margin/deferred/{id}/claim

The goods were sold outside the scheme: the deduction arises when the tax on that sale is due (§ 90 odst. 16), and reaches that period’s return

MCP tool: claim-margin-deferred-deduction

Path parameters

idstringrequired

Request body

saleDocumentIdstringrequired
ID of the sale document.

Response · 200

idstringrequired
receivedInvoiceIdstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
vatHalerinteger | nullrequired
caseCodestringrequired
descriptionnull | stringrequired
statusstringrequired
saleDocumentIdnull | string
saleDocumentTypenull | string
claimedOnnull | stringdate
POST/v1/tax/margin/deferred/{id}/claim
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/claim \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "saleDocumentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

The goods were sold in the scheme after all: no deduction will arise (§ 90 odst. 11)

POST/v1/tax/margin/deferred/{id}/sold-in-scheme

The goods were sold in the scheme after all: no deduction will arise (§ 90 odst. 11)

MCP tool: close-margin-deferred-deduction

Path parameters

idstringrequired

Response · 200

idstringrequired
receivedInvoiceIdstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
vatHalerinteger | nullrequired
caseCodestringrequired
descriptionnull | stringrequired
statusstringrequired
saleDocumentIdnull | string
saleDocumentTypenull | string
claimedOnnull | stringdate
POST/v1/tax/margin/deferred/{id}/sold-in-scheme
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sold-in-scheme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Tax periods whose § 90 margin is set per period and rate (§ 90 odst. 4), with sales, purchases, margin and tax

GET/v1/tax/margin/periods

Tax periods whose § 90 margin is set per period and rate (§ 90 odst. 4), with sales, purchases, margin and tax

MCP tool: list-margin-periods

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_margin_period"required
idstringrequired
fromstringrequireddate
tostringrequireddate
purchasesobject[]required
vatRateintegerrequired
purchaseHalerintegerrequired
statusstringrequired
closedAtnull | stringrequireddate-time
ratesobject[]required
vatRateintegerrequired
salesHalerintegerrequired
purchaseHalerintegerrequired
marginHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
vatHalerinteger | nullrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/margin/periods
curl https://api.damedoklad.cz/v1/tax/margin/periods \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Set the § 90 margin of the tax period holding a date by its purchases per rate, instead of per line. The whole period follows it (§ 90 odst. 6)

PUT/v1/tax/margin/periods

Set the § 90 margin of the tax period holding a date by its purchases per rate, instead of per line. The whole period follows it (§ 90 odst. 6)

MCP tool: set-margin-period

Request body

datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
purchasesobject[]required
vatRatenumberrequiredmin 0max 100
purchaseHalerintegerrequiredmin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
confirmedUnitLimittruerequired

Response · 200

idstringrequired
fromstringrequireddate
tostringrequireddate
purchasesobject[]required
vatRateintegerrequired
purchaseHalerintegerrequired
statusstringrequired
closedAtnull | stringrequireddate-time
ratesobject[]required
vatRateintegerrequired
salesHalerintegerrequired
purchaseHalerintegerrequired
marginHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
vatHalerinteger | nullrequired
PUT/v1/tax/margin/periods
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/periods \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "purchases": [
    {
      "vatRate": 21,
      "purchaseHaler": 1210000
    }
  ],
  "confirmedUnitLimit": true
}'

Go back to a margin per line for an open tax period

DELETE/v1/tax/margin/periods/{id}

Go back to a margin per line for an open tax period

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-margin-period

Path parameters

idstringrequired

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/tax/margin/periods/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Close a § 90 odst. 4 period: posts the tax on the margin MD revenue / D 343 on its last day, or a cash book row with no money in daňová evidence

POST/v1/tax/margin/periods/{id}/close

Close a § 90 odst. 4 period: posts the tax on the margin MD revenue / D 343 on its last day, or a cash book row with no money in daňová evidence

MCP tool: close-margin-period

Path parameters

idstringrequired

Response · 200

idstringrequired
fromstringrequireddate
tostringrequireddate
purchasesobject[]required
vatRateintegerrequired
purchaseHalerintegerrequired
statusstringrequired
closedAtnull | stringrequireddate-time
ratesobject[]required
vatRateintegerrequired
salesHalerintegerrequired
purchaseHalerintegerrequired
marginHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
vatHalerinteger | nullrequired
POST/v1/tax/margin/periods/{id}/close
curl -X POST https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Reopen a closed § 90 odst. 4 period and reverse what closing it posted

POST/v1/tax/margin/periods/{id}/reopen

Reopen a closed § 90 odst. 4 period and reverse what closing it posted

MCP tool: reopen-margin-period

Path parameters

idstringrequired

Response · 200

idstringrequired
fromstringrequireddate
tostringrequireddate
purchasesobject[]required
vatRateintegerrequired
purchaseHalerintegerrequired
statusstringrequired
closedAtnull | stringrequireddate-time
ratesobject[]required
vatRateintegerrequired
salesHalerintegerrequired
purchaseHalerintegerrequired
marginHalerintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
vatHalerinteger | nullrequired
POST/v1/tax/margin/periods/{id}/reopen
curl -X POST https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Výkup: goods bought for resale under § 90 from someone odst. 2 allows, and which of them are still unsold

GET/v1/tax/margin/purchases

Výkup: goods bought for resale under § 90 from someone odst. 2 allows, and which of them are still unsold

MCP tool: list-margin-purchases

Query parameters

available"true" | "false"
limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_margin_purchase"required
idstringrequired
numberstringrequired
purchasedOnstringrequireddate
sellerKindstringrequired
sellerNamestringrequired
sellerAddressnull | stringrequired
sellerIcostring | nullrequired
sellerDocumentnull | stringrequired
contactIdstring | nullrequired
receivedInvoiceIdstring | nullrequired
vatModestringrequired
totalHalerintegerrequired
notestring | nullrequired
linesobject[]required
idstringrequired
positioninteger | nullrequired
descriptionnull | stringrequired
serialNumbernull | stringrequired
purchaseHalerintegerrequired
soldDocumentIdstring | null
soldDocumentTypestring | null
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/margin/purchases
curl https://api.damedoklad.cz/v1/tax/margin/purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Buy goods for resale under § 90 from a non-payer or another person odst. 2 allows. With recordInvoice it also records the cost as a received invoice without VAT, to be paid as any other

POST/v1/tax/margin/purchases

Buy goods for resale under § 90 from a non-payer or another person odst. 2 allows. With recordInvoice it also records the cost as a received invoice without VAT, to be paid as any other

MCP tool: create-margin-purchase

Request body

purchasedOnstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
sellerKind"non_taxable" | "small_business" | "exempt_62" | "margin_dealer"required
sellerNamestringrequiredmax 200 chars
sellerAddressstring | null
sellerIcostring | null
Czech company number (IČO), 8 digits.
sellerDocumentstring | null
contactIdstring | null
ID of the contact. Find it with list-contacts.
vatMode"margin_used_goods" | "margin_art" | "margin_collectibles"
notestring | null
recordInvoiceboolean
linesobject[]required
descriptionstringrequiredmax 240 chars
serialNumberstring | null
purchaseHalerintegerrequiredmin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.

Response · 201

idstringrequired
numberstringrequired
purchasedOnstringrequireddate
sellerKindstringrequired
sellerNamestringrequired
sellerAddressnull | stringrequired
sellerIcostring | nullrequired
sellerDocumentnull | stringrequired
contactIdstring | nullrequired
receivedInvoiceIdstring | nullrequired
vatModestringrequired
totalHalerintegerrequired
notestring | nullrequired
linesobject[]required
idstringrequired
positioninteger | nullrequired
descriptionnull | stringrequired
serialNumbernull | stringrequired
purchaseHalerintegerrequired
soldDocumentIdstring | null
soldDocumentTypestring | null
POST/v1/tax/margin/purchases
curl -X POST https://api.damedoklad.cz/v1/tax/margin/purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "purchasedOn": "2026-10-30",
  "sellerKind": "non_taxable",
  "sellerName": "Pekárna U Lípy s.r.o.",
  "lines": [
    {
      "description": "Pečivo, říjen",
      "purchaseHaler": 1210000
    }
  ]
}'

The purchase document for a výkup, for the seller to sign

GET/v1/tax/margin/purchases/{id}/pdf

The purchase document for a výkup, for the seller to sign

MCP tool: get-margin-purchase-pdf

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

GET/v1/tax/margin/purchases/{id}/pdf
curl https://api.damedoklad.cz/v1/tax/margin/purchases/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Whether the margin schemes are offered on documents, and the drafts waiting for a purchase price

GET/v1/tax/margin/settings

Whether the margin schemes are offered on documents, and the drafts waiting for a purchase price

MCP tool: get-margin-settings

Response · 200

enabledbooleanrequired
draftsobject[]required
documentIdnull | stringrequired
documentTypenull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
totalHalerinteger | nullrequired
vatModestringrequired
GET/v1/tax/margin/settings
curl https://api.damedoklad.cz/v1/tax/margin/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Offer the § 89 and § 90 margin schemes on documents, or stop offering them

PUT/v1/tax/margin/settings

Offer the § 89 and § 90 margin schemes on documents, or stop offering them

MCP tool: set-margin-settings

Request body

enabledbooleanrequired

Response · 200

enabledbooleanrequired
draftsobject[]required
documentIdnull | stringrequired
documentTypenull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
totalHalerinteger | nullrequired
vatModestringrequired
PUT/v1/tax/margin/settings
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": false
}'

Minimum monthly social and health advances of a self-employed person for a year, from the verified tables

GET/v1/tax/osvc/minimum-advances

Minimum monthly social and health advances of a self-employed person for a year, from the verified tables

MCP tool: get-osvc-minimum-advances

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

yearintegerrequired
averageWageintegerrequired
mainobjectrequired
baseintegerrequired
advanceintegerrequired
mainStartobjectrequired
baseintegerrequired
advanceintegerrequired
sideobjectrequired
baseintegerrequired
advanceintegerrequired
healthobjectrequired
basenumberrequired
advanceintegerrequired
GET/v1/tax/osvc/minimum-advances
curl https://api.damedoklad.cz/v1/tax/osvc/minimum-advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

VAT to pay or refund for a period, filing deadlines with their status, and next income and road tax dates

GET/v1/tax/overview

VAT to pay or refund for a period, filing deadlines with their status, and next income and road tax dates

MCP tool: get-tax-overview

Query parameters

yearintegermin 2016max 2100
monthintegermin 1max 12
quarterintegermin 1max 4

Response · 200

vatPayerbooleanrequired
frequencystringrequired
regimestringrequired
profileCompletebooleanrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
vatToPayKcintegerrequired
vatRefundKcintegerrequired
outputVatKcintegerrequired
deductionKcintegerrequired
documentsintegerrequired
issuesany[]required
issuesCountintegerrequired
deadlinesobject[]required
formstringrequired
periodKeystringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
statusstringrequired
daysLeftintegerrequired
overduebooleanrequired
otherDeadlinesobject[]required
formstringrequired
periodKeystringrequired
yearintegerrequired
monthinteger | nullrequired
quarterinteger | nullrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
statusstringrequired
daysLeftintegerrequired
overduebooleanrequired
upcomingobject[]required
keystringrequired
formstringrequired
datestringrequireddate
periodstringrequired
overduebooleanrequired
labelCsstringrequired
labelEnstringrequired
GET/v1/tax/overview
curl https://api.damedoklad.cz/v1/tax/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Get the tax details filings need: finance office, address, signer

GET/v1/tax/profile

Get the tax details filings need: finance office, address, signer

MCP tool: get-tax-profile

Response · 200

namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
regimestringrequired
vatPayerbooleanrequired
vatPeriodstringrequired
subjectTypestringrequired
firstNamenull | stringrequired
lastNamenull | stringrequired
titlestring | nullrequired
financeOfficeCodenull | stringrequired
workplaceCodenull | stringrequired
naceCodenull | stringrequired
streetnull | stringrequired
houseNumbernull | stringrequired
orientationNumberstring | nullrequired
citynull | stringrequired
postalCodenull | stringrequired
countrystring | nullrequired
phonenull | stringrequired
emailnull | stringrequired
contactFirstNamestring | nullrequired
contactLastNamestring | nullrequired
contactPhonestring | nullrequired
signerFirstNamenull | stringrequired
signerLastNamenull | stringrequired
signerRolenull | stringrequired
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredbooleanrequired
ossImportRegisteredbooleanrequired
ownsPropertybooleanrequired
GET/v1/tax/profile
curl https://api.damedoklad.cz/v1/tax/profile \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Update the tax details filings need

PATCH/v1/tax/profile

Update the tax details filings need

MCP tool: update-tax-profile

Request body

subjectType"F" | "P"
firstNamestringmax 30 chars
lastNamestringmax 36 chars
titlestringmax 10 chars
financeOfficeCodestring
workplaceCodestring
naceCodestring
streetstringmax 38 chars
houseNumberstring
orientationNumberstringmax 4 chars
citystringmax 48 chars
postalCodestring
countrystringmax 25 chars
phonestringmax 14 chars
emailstringmax 255 charsemail
contactFirstNamestringmax 20 chars
contactLastNamestringmax 36 chars
contactPhonestringmax 14 chars
signerFirstNamestringmax 20 chars
signerLastNamestringmax 36 chars
signerRolestringmax 40 chars
summaryQuarterlyboolean
ossRegisteredboolean
ossNonEuRegisteredboolean
ossImportRegisteredboolean
ownsPropertyboolean

Response · 200

namenull | stringrequired
dicnull | stringrequired
iconull | stringrequired
regimestringrequired
vatPayerbooleanrequired
vatPeriodstringrequired
subjectTypestringrequired
firstNamenull | stringrequired
lastNamenull | stringrequired
titlestring | nullrequired
financeOfficeCodenull | stringrequired
workplaceCodenull | stringrequired
naceCodenull | stringrequired
streetnull | stringrequired
houseNumbernull | stringrequired
orientationNumberstring | nullrequired
citynull | stringrequired
postalCodenull | stringrequired
countrystring | nullrequired
phonenull | stringrequired
emailnull | stringrequired
contactFirstNamestring | nullrequired
contactLastNamestring | nullrequired
contactPhonestring | nullrequired
signerFirstNamenull | stringrequired
signerLastNamenull | stringrequired
signerRolenull | stringrequired
summaryQuarterlybooleanrequired
ossRegisteredbooleanrequired
ossNonEuRegisteredbooleanrequired
ossImportRegisteredbooleanrequired
ownsPropertybooleanrequired
PATCH/v1/tax/profile
curl -X PATCH https://api.damedoklad.cz/v1/tax/profile \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subjectType": "F",
  "firstName": "Pekárna U Lípy s.r.o.",
  "lastName": "Pekárna U Lípy s.r.o."
}'

Legal grounds of exemption from property tax claimed in the return, for a year: § 4 for land, § 9 for buildings, § 17a, from the code list of the Finanční správa

GET/v1/tax/property/exemptions

Legal grounds of exemption from property tax claimed in the return, for a year: § 4 for land, § 9 for buildings, § 17a, from the code list of the Finanční správa

MCP tool: list-property-exemptions

Query parameters

yearintegerrequiredmin 2016max 2100
limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
kindstringrequired
sectionstringrequired
letterstringrequired
substring
labelnull | stringrequired
sinceinteger
timeLimitedboolean
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/property/exemptions
curl https://api.damedoklad.cz/v1/tax/property/exemptions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Deduction coefficient (§ 76) for a year and its settlement preview from the year’s documents

GET/v1/tax/regimes/coefficient

Deduction coefficient (§ 76) for a year and its settlement preview from the year’s documents

MCP tool: get-tax-coefficient

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

yearintegerrequired
coefficientinteger | nullrequired
sourcenull | string
settlementCoefficientinteger | null
settlementChangeHalerinteger | null
settledAtstring | null
previewobject
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
settledboolean
numeratorinteger
exemptinteger
reducedInputinteger
claimedinteger
entitledinteger
changeinteger
appliesboolean
GET/v1/tax/regimes/coefficient
curl https://api.damedoklad.cz/v1/tax/regimes/coefficient \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Set the coefficient used during a year (§ 76 odst. 6), usually a qualified estimate in the first year

PUT/v1/tax/regimes/coefficient

Set the coefficient used during a year (§ 76 odst. 6), usually a qualified estimate in the first year

MCP tool: set-tax-coefficient

Query parameters

yearintegerrequiredmin 2016max 2100

Request body

coefficientinteger | nullrequired

Response · 200

yearintegerrequired
coefficientinteger | nullrequired
sourcenull | string
settlementCoefficientinteger | null
settlementChangeHalerinteger | null
settledAtstring | null
previewobject
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
settledboolean
numeratorinteger
exemptinteger
reducedInputinteger
claimedinteger
entitledinteger
changeinteger
appliesboolean
PUT/v1/tax/regimes/coefficient
curl -X PUT https://api.damedoklad.cz/v1/tax/regimes/coefficient \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "coefficient": 0
}'

Run the year-end settlement (§ 76 odst. 7): stores the settlement coefficient and the change for ř. 53

POST/v1/tax/regimes/coefficient/settle

Run the year-end settlement (§ 76 odst. 7): stores the settlement coefficient and the change for ř. 53

MCP tool: settle-tax-coefficient

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

yearintegerrequired
coefficientinteger | nullrequired
sourcenull | string
settlementCoefficientinteger | null
settlementChangeHalerinteger | null
settledAtstring | null
previewobject
numeratorintegerrequired
exemptintegerrequired
reducedInputintegerrequired
claimedintegerrequired
coefficientinteger | nullrequired
entitledintegerrequired
changeintegerrequired
appliesbooleanrequired
settledboolean
numeratorinteger
exemptinteger
reducedInputinteger
claimedinteger
entitledinteger
changeinteger
appliesboolean
POST/v1/tax/regimes/coefficient/settle
curl -X POST https://api.damedoklad.cz/v1/tax/regimes/coefficient/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

OSS return summary for a period by member state and rate, with the due date: a quarter, or a month for the import scheme

GET/v1/tax/regimes/oss

OSS return summary for a period by member state and rate, with the due date: a quarter, or a month for the import scheme

MCP tool: get-vat-oss

Query parameters

datestringYYYY-MM-DD
Date as YYYY-MM-DD.
yearintegerrequiredmin -9007199254740991max 9007199254740991
quarterintegermin 1max 4
monthintegermin 1max 12
scheme"EU" | "NON_EU" | "IMPORT"

Response · 200

periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
schemestringrequired
deadlineobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
periodobjectrequired
yearintegerrequired
monthinteger | null
keystringrequired
fromstringrequireddate
tostringrequireddate
quarterinteger | null
rowsobject[]required
countrynull | stringrequired
rateintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
issuesany[]required
totalVatHalerintegerrequired
GET/v1/tax/regimes/oss
curl https://api.damedoklad.cz/v1/tax/regimes/oss \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

ECB reference rate CZK/EUR for the last day of a quarter or, for the import scheme, a month, or the next day it was published (§ 110ze zákona o DPH). With date, that day: the first of the year for the small business scheme (§ 109bs)

GET/v1/tax/regimes/oss/ecb-rate

ECB reference rate CZK/EUR for the last day of a quarter or, for the import scheme, a month, or the next day it was published (§ 110ze zákona o DPH). With date, that day: the first of the year for the small business scheme (§ 109bs)

MCP tool: get-oss-ecb-rate

Query parameters

datestringYYYY-MM-DD
Date as YYYY-MM-DD.
yearintegerrequiredmin -9007199254740991max 9007199254740991
quarterintegermin 1max 4
monthintegermin 1max 12

Response · 200

datestringrequireddate
ratenumberrequired
requestedForstringrequireddate
sourcestringrequired
GET/v1/tax/regimes/oss/ecb-rate
curl https://api.damedoklad.cz/v1/tax/regimes/oss/ecb-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Special VAT regimes in a period: § 92a both sides, self-assessed EU documents, advances, bad debts, § 92a codes

GET/v1/tax/regimes/overview

Special VAT regimes in a period: § 92a both sides, self-assessed EU documents, advances, bad debts, § 92a codes

MCP tool: get-vat-regimes

Query parameters

yearintegermin 2016max 2100
monthintegermin 1max 12
quarterintegermin 1max 4

Response · 200

periodobjectrequired
yearintegerrequired
monthinteger | nullrequired
keystringrequired
fromstringrequireddate
tostringrequireddate
reverseChargeSuppliedany[]required
reverseChargeReceivedany[]required
selfAssessedany[]required
advancesany[]required
partialDeductionsany[]required
codesobject[]required
codenull | stringrequired
labelnull | stringrequired
countriesstring[]required
treatmentsstring[]required
GET/v1/tax/regimes/overview
curl https://api.damedoklad.cz/v1/tax/regimes/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Road tax for a year from the vehicle register, with the rate of each vehicle and the due date

GET/v1/tax/road

Road tax for a year from the vehicle register, with the rate of each vehicle and the due date

MCP tool: get-road-tax

Query parameters

yearintegerrequiredmin 2016max 2100

Response · 200

yearintegerrequired
rowsobject[]required
platestringrequired
codenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
rateintegerrequired
monthsintegerrequired
grossintegerrequired
exemptLetterstring | nullrequired
exemptMonthsintegerrequired
exemptintegerrequired
discountintegerrequired
partialintegerrequired
outsidebooleanrequired
reportablebooleanrequired
idstringrequired
namestring | nullrequired
totalintegerrequired
payableintegerrequired
deadlineobjectrequired
statutorystringrequireddate
duestringrequireddate
movedbooleanrequired
GET/v1/tax/road
curl https://api.damedoklad.cz/v1/tax/road \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

The small business scheme for other EU states (§ 109bb ZDPH): the -EX number, the states, and what was entered by hand

GET/v1/tax/sme

The small business scheme for other EU states (§ 109bb ZDPH): the -EX number, the states, and what was entered by hand

MCP tool: get-vat-sme

Response · 200

registeredbooleanrequired
evidenceNumbernull | stringrequired
statesobject[]required
countrynull | stringrequired
fromstringrequireddate
toanyrequired
Null in every recorded response.
adjustmentsany[]required
registeredForCzechiabooleanrequired
GET/v1/tax/sme
curl https://api.damedoklad.cz/v1/tax/sme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record the registration for the small business scheme in other EU states, as the tax office decided it

PUT/v1/tax/sme

Record the registration for the small business scheme in other EU states, as the tax office decided it

MCP tool: set-vat-sme

Request body

evidenceNumberstringrequiredmin 4 charsmax 16 chars
statesobject[]required
countrystringrequired2 chars
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostring | null
Date as YYYY-MM-DD.

Response · 200

registeredbooleanrequired
evidenceNumbernull | stringrequired
statesobject[]required
countrynull | stringrequired
fromstringrequireddate
toanyrequired
Null in every recorded response.
adjustmentsany[]required
registeredForCzechiabooleanrequired
PUT/v1/tax/sme
curl -X PUT https://api.damedoklad.cz/v1/tax/sme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "evidenceNumber": "string",
  "states": [
    {
      "country": "string",
      "from": "2026-10-30"
    }
  ]
}'

Say a company seated in another state uses the scheme here: the limits of § 6 then apply to it instead of § 6c. Its filings go to its own state (§ 109bg)

PUT/v1/tax/sme/czechia

Say a company seated in another state uses the scheme here: the limits of § 6 then apply to it instead of § 6c. Its filings go to its own state (§ 109bg)

MCP tool: set-vat-sme-for-czechia

Request body

registeredbooleanrequired

Response · 200

registeredbooleanrequired
evidenceNumbernull | stringrequired
statesobject[]required
countrynull | stringrequired
fromstringrequireddate
toanyrequired
Null in every recorded response.
adjustmentsany[]required
registeredForCzechiabooleanrequired
PUT/v1/tax/sme/czechia
curl -X PUT https://api.damedoklad.cz/v1/tax/sme/czechia \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registered": false
}'

The year against the 100 000 EUR limit with the day it was passed, and a quarter’s figures per state in euros as the notice states them, at the ECB rate of the first day of the year

GET/v1/tax/sme/notice

The year against the 100 000 EUR limit with the day it was passed, and a quarter’s figures per state in euros as the notice states them, at the ECB rate of the first day of the year. File it through a tax filing with the form SMEHL1 or SMEOZ1. Which supplies fall in a state’s turnover is that state’s law: enter what the documents do not say with createVatSmeTurnover.

MCP tool: get-vat-sme-notice

Query parameters

yearintegerrequiredmin 2025max 2100
quarterintegermin 1max 4
eurRatenumber

Response · 200

yearintegerrequired
quarterinteger | nullrequired
limitobjectrequired
object"vat_sme_limit"required
yearintegerrequired
eurRateinteger | nullrequired
limitCentsintegerrequired
turnoverCentsintegerrequired
remainingCentsintegerrequired
previousYearCentsanyrequired
Null in every recorded response.
previousYearExceededbooleanrequired
exceededOnnull | stringrequireddate
noticeDuenull | stringrequireddate
usableUntilnull | stringrequireddate
noticenull | objectrequired
yearintegerrequired
quarterinteger | nullrequired
fromstringrequireddate
tostringrequireddate
duestringrequireddate
rowsobject[]required
countrynull | stringrequired
sectornull | stringrequired
centsintegerrequired
issuesany[]required
totalCentsintegerrequired
GET/v1/tax/sme/notice
curl https://api.damedoklad.cz/v1/tax/sme/notice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add to a state’s turnover by hand: a sector where the state has thresholds by sector, or a supply the documents do not show

POST/v1/tax/sme/turnover

Add to a state’s turnover by hand: a sector where the state has thresholds by sector, or a supply the documents do not show

MCP tool: create-vat-sme-turnover

Request body

datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
countrystringrequired2 chars
amountHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
sectorstring | null
notestring | null

Response · 201

idstringrequired
datestringrequireddate
countrynull | stringrequired
amountHalerinteger | nullrequired
sectornull | stringrequired
notestring | nullrequired
POST/v1/tax/sme/turnover
curl -X POST https://api.damedoklad.cz/v1/tax/sme/turnover \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "country": "string",
  "amountHaler": 1210000
}'

Remove a figure entered by hand

DELETE/v1/tax/sme/turnover/{id}

Remove a figure entered by hand

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-vat-sme-turnover

Path parameters

idstringrequired

Response · 200

idstringrequired
datestringrequireddate
countrynull | stringrequired
amountHalerinteger | nullrequired
sectornull | stringrequired
notestring | nullrequired
DELETE/v1/tax/sme/turnover/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/sme/turnover/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Check a supplier before paying: unreliable payer status and whether the bank account is published (ADIS)

POST/v1/tax/suppliers/check

Check a supplier before paying: unreliable payer status and whether the bank account is published (ADIS)

MCP tool: check-supplier-reliability

Request body

dicstringrequiredmin 3 charsmax 14 chars
VAT number (DIČ), for example CZ12345678.
bankAccountstringmax 40 chars

Response · 200

dicstringrequired
statusstringrequired
sourcestringrequired
unreliableSincestring | nullrequired
publishedAccountsobject[]required
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
checkedAtstringrequireddate-time
accountPublishedanyrequired
Null in every recorded response.
POST/v1/tax/suppliers/check
curl -X POST https://api.damedoklad.cz/v1/tax/suppliers/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dic": "CZ12345678"
}'

Unpaid received invoices with the last known supplier status and account check, so risky payments stand out

GET/v1/tax/suppliers/unpaid

Unpaid received invoices with the last known supplier status and account check, so risky payments stand out

MCP tool: list-unpaid-supplier-checks

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_unpaid_invoice"required
idstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
dicnull | stringrequired
dueDatenull | stringrequireddate
totalHalerinteger | nullrequired
accountnull | stringrequired
accountPublishedboolean | nullrequired
statusnull | stringrequired
sourcenull | stringrequired
checkedAtnull | stringrequireddate-time
unreliableSincestring | nullrequired
riskstringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/suppliers/unpaid
curl https://api.damedoklad.cz/v1/tax/suppliers/unpaid \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Check every supplier of an unpaid received invoice against ADIS and store the answers

POST/v1/tax/suppliers/unpaid/check

Check every supplier of an unpaid received invoice against ADIS and store the answers

MCP tool: run-unpaid-supplier-checks

Response · 200

dataobject[]required
object"tax_unpaid_invoice"required
idstringrequired
numbernull | stringrequired
supplierNumberstringrequired
contactNamenull | stringrequired
dicnull | stringrequired
dueDatenull | stringrequireddate
totalHalerinteger | nullrequired
accountnull | stringrequired
accountPublishedboolean | nullrequired
statusnull | stringrequired
sourcenull | stringrequired
checkedAtnull | stringrequireddate-time
unreliableSincestring | nullrequired
riskstringrequired
totalintegerrequired
hasMorebooleanrequired
checkedintegerrequired
POST/v1/tax/suppliers/unpaid/check
curl -X POST https://api.damedoklad.cz/v1/tax/suppliers/unpaid/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Whether the company is in a VAT group (§ 5a ZDPH), in which role and from when

GET/v1/tax/vat-group

Whether the company is in a VAT group (§ 5a ZDPH), in which role and from when

MCP tool: get-vat-group

Response · 200

registeredbooleanrequired
activebooleanrequired
rolenull | stringrequired
namenull | stringrequired
dicnull | stringrequired
fromnull | stringrequireddate
toanyrequired
Null in every recorded response.
applicationOnanyrequired
Null in every recorded response.
earliestFromanyrequired
Null in every recorded response.
previousDicnull | stringrequired
membersobject[]required
iconull | stringrequired
namenull | stringrequired
filesOwnReturnbooleanrequired
GET/v1/tax/vat-group
curl https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record the VAT group: its number, this company’s role, and the other members. From the date the company is a payer under the group’s number and a member files no return itself

PUT/v1/tax/vat-group

Record the VAT group: its number, this company’s role, and the other members. From the date the company is a payer under the group’s number and a member files no return itself. A decision of the tax office makes a group, not this record. Application dates and their deadlines are checked by getVatGroupStart: the record is what the office decided.

MCP tool: set-vat-group

Request body

role"representative" | "member"required
namestringrequiredmax 200 chars
dicstringrequiredmin 10 charsmax 14 chars
VAT number (DIČ), for example CZ12345678.
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostring | null
Date as YYYY-MM-DD.
applicationOnstring | null
Date as YYYY-MM-DD.
membersobject[]
namestringrequiredmax 200 chars
icostring | null
Czech company number (IČO), 8 digits.
contactIdstring | null
ID of the contact. Find it with list-contacts.

Response · 200

registeredbooleanrequired
activebooleanrequired
rolenull | stringrequired
namenull | stringrequired
dicnull | stringrequired
fromnull | stringrequireddate
toanyrequired
Null in every recorded response.
applicationOnanyrequired
Null in every recorded response.
earliestFromanyrequired
Null in every recorded response.
previousDicnull | stringrequired
membersobject[]required
iconull | stringrequired
namenull | stringrequired
filesOwnReturnbooleanrequired
PUT/v1/tax/vat-group
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "representative",
  "name": "Pekárna U Lípy s.r.o.",
  "dic": "CZ12345678",
  "from": "2026-10-30"
}'

Remove a group entered by mistake and give the company its number back. A membership that ended is ended with a date, as documents stand on it

DELETE/v1/tax/vat-group

Remove a group entered by mistake and give the company its number back. A membership that ended is ended with a date, as documents stand on it

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-vat-group

Response · 200

registeredbooleanrequired
activebooleanrequired
rolenull | stringrequired
namenull | stringrequired
dicnull | stringrequired
fromnull | stringrequireddate
toanyrequired
Null in every recorded response.
applicationOnanyrequired
Null in every recorded response.
earliestFromanyrequired
Null in every recorded response.
previousDicnull | stringrequired
membersobject[]required
iconull | stringrequired
namenull | stringrequired
filesOwnReturnbooleanrequired
DELETE/v1/tax/vat-group
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

This member’s part of the group’s return and KH for a period, to give to the representative. What passed between members is left out

GET/v1/tax/vat-group/contribution

This member’s part of the group’s return and KH for a period, to give to the representative. What passed between members is left out

MCP tool: get-vat-group-contribution

Query parameters

fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

iconull | stringrequired
namenull | stringrequired
fromstringrequireddate
tostringrequireddate
entriesobject[]required
documentIdnull | stringrequired
documentTypenull | stringrequired
numbernull | stringrequired
evidenceNumbernull | stringrequired
contactNamenull | stringrequired
contactDicstring | nullrequired
contactCountrystringrequired
datestringrequireddate
taxPointDatenull | stringrequireddate
treatmentnull | stringrequired
isDefaultTreatmentbooleanrequired
rateintegerrequired
bandnull | stringrequired
columninteger | nullrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
deductibleVatHalerintegerrequired
carLimitedbooleanrequired
coefficientExcludedbooleanrequired
deductionnull | stringrequired
deductionPercentinteger | nullrequired
reverseChargeCodestring | nullrequired
specialRegimeintegerrequired
documentTotalHalerintegerrequired
isBadDebtbooleanrequired
khGroupIdanyrequired
Null in every recorded response.
isDebtorCorrectionbooleanrequired
offLedgerbooleanrequired
isCorrectionbooleanrequired
ossCountrynull | stringrequired
ossRatestring | nullrequired
ossRateTypestring | nullrequired
ossSupplyTypestring | nullrequired
ossSchemestring | nullrequired
currencynull | stringrequired
documentNetHalerintegerrequired
GET/v1/tax/vat-group/contribution
curl https://api.damedoklad.cz/v1/tax/vat-group/contribution \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

What the members handed over, as the representative has it

GET/v1/tax/vat-group/contributions

What the members handed over, as the representative has it

MCP tool: list-vat-group-contributions

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"vat_group_contribution_saved"required
idstringrequired
icostring | nullrequired
namenull | stringrequired
fromstringrequireddate
tostringrequireddate
entryCountintegerrequired
createdAtstringdate-time
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/vat-group/contributions
curl https://api.damedoklad.cz/v1/tax/vat-group/contributions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Take in a member’s part of the return. The same member and period replaces the earlier one, and the return and KH then read it with the company’s own documents

POST/v1/tax/vat-group/contributions

Take in a member’s part of the return. The same member and period replaces the earlier one, and the return and KH then read it with the company’s own documents

MCP tool: save-vat-group-contribution

Request body

icostring | null
Czech company number (IČO), 8 digits.
namestring | null
fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
entriesobject[]required

Response · 201

idstringrequired
icostring | nullrequired
namenull | stringrequired
fromstringrequireddate
tostringrequireddate
entryCountintegerrequired
createdAtstringdate-time
POST/v1/tax/vat-group/contributions
curl -X POST https://api.damedoklad.cz/v1/tax/vat-group/contributions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "2026-10-30",
  "to": "2026-10-30",
  "entries": [
    {}
  ]
}'

Remove a member’s part from the return

DELETE/v1/tax/vat-group/contributions/{id}

Remove a member’s part from the return

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-vat-group-contribution

Path parameters

idstringrequired

Response · 200

idstringrequired
icostring | nullrequired
namenull | stringrequired
fromstringrequireddate
tostringrequireddate
entryCountintegerrequired
createdAtstringdate-time
DELETE/v1/tax/vat-group/contributions/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-group/contributions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

What passed between members of the group, kept apart as § 100 odst. 4 asks. None of it is in the return

GET/v1/tax/vat-group/internal

What passed between members of the group, kept apart as § 100 odst. 4 asks. None of it is in the return

MCP tool: get-vat-group-internal-supplies

Query parameters

fromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
tostringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

fromstringrequireddate
tostringrequireddate
rowsobject[]required
documentTypenull | stringrequired
documentIdnull | stringrequired
numbernull | stringrequired
taxPointDatenull | stringrequireddate
contactNamenull | stringrequired
totalHalerinteger | nullrequired
totalHalerinteger | nullrequired
GET/v1/tax/vat-group/internal
curl https://api.damedoklad.cz/v1/tax/vat-group/internal \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

The first day a company can be in a group, from the day of the application (§ 94a odst. 2 to 4 ZDPH)

GET/v1/tax/vat-group/start

The first day a company can be in a group, from the day of the application (§ 94a odst. 2 to 4 ZDPH)

MCP tool: get-vat-group-start

Query parameters

applicationOnstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

applicationOnstringrequireddate
fromstringrequireddate
GET/v1/tax/vat-group/start
curl https://api.damedoklad.cz/v1/tax/vat-group/start \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

VAT status of the company today and from which dates it changed

GET/v1/tax/vat-status

VAT status of the company today and from which dates it changed

MCP tool: get-vat-status

Response · 200

vatPayerbooleanrequired
vatPeriodstringrequired
dicnull | stringrequired
historyobject[]required
fromnull | stringrequireddate
vatPayerbooleanrequired
vatPeriodstringrequired
notenull | stringrequired
payerSincenull | stringrequireddate
seatAbroadbooleanrequired
identifiedFromnull | stringrequireddate
GET/v1/tax/vat-status
curl https://api.damedoklad.cz/v1/tax/vat-status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Become or stop being a VAT payer from a date. Documents follow their own date: before it the old status, from it the new one

POST/v1/tax/vat-status

Become or stop being a VAT payer from a date. Documents follow their own date: before it the old status, from it the new one. A new payer is monthly in the year of registration and the next (§ 99a odst. 3 ZDPH). The § 79 deduction and § 79a reduction are entered on ř. 45 as adjustments. Documents already issued are not changed: previewVatStatusChange lists them.

MCP tool: change-vat-status

Request body

effectiveFromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
vatPayerbooleanrequired
vatPeriod"monthly" | "quarterly"
dicstringmax 14 chars
VAT number (DIČ), for example CZ12345678.
notestringmax 240 chars
confirmtruerequired

Response · 201

vatPayerbooleanrequired
vatPeriodstringrequired
dicnull | stringrequired
historyobject[]required
fromnull | stringrequireddate
vatPayerbooleanrequired
vatPeriodstringrequired
notenull | stringrequired
payerSincenull | stringrequireddate
seatAbroadbooleanrequired
identifiedFromnull | stringrequireddate
POST/v1/tax/vat-status
curl -X POST https://api.damedoklad.cz/v1/tax/vat-status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "effectiveFrom": "2026-10-30",
  "vatPayer": false,
  "confirm": true
}'

Remove a change of VAT status entered for a date

DELETE/v1/tax/vat-status/{date}

Remove a change of VAT status entered for a date

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-vat-status-change

Path parameters

datestringrequired
Date as YYYY-MM-DD.

Response · 200

vatPayerbooleanrequired
vatPeriodstringrequired
dicnull | stringrequired
historyobject[]required
fromnull | stringrequireddate
vatPayerbooleanrequired
vatPeriodstringrequired
notenull | stringrequired
payerSincenull | stringrequireddate
seatAbroadbooleanrequired
identifiedFromnull | stringrequireddate
DELETE/v1/tax/vat-status/{date}
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-status/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record that a non-payer has been an identified person since a date (§ 6g to § 6l): it self-assesses services and goods from abroad with no deduction

PUT/v1/tax/vat-status/identified

Record that a non-payer has been an identified person since a date (§ 6g to § 6l): it self-assesses services and goods from abroad with no deduction

MCP tool: set-vat-identified-person

Request body

fromstring | nullrequired
Date as YYYY-MM-DD.

Response · 200

vatPayerbooleanrequired
vatPeriodstringrequired
dicnull | stringrequired
historyobject[]required
fromnull | stringrequireddate
vatPayerbooleanrequired
vatPeriodstringrequired
notenull | stringrequired
payerSincenull | stringrequireddate
seatAbroadbooleanrequired
identifiedFromnull | stringrequireddate
PUT/v1/tax/vat-status/identified
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-status/identified \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "2026-10-30"
}'

What a change of VAT status on a date would touch: documents on the wrong side of it, and § 79 deduction or § 79a reduction to go through

GET/v1/tax/vat-status/review

What a change of VAT status on a date would touch: documents on the wrong side of it, and § 79 deduction or § 79a reduction to go through

MCP tool: preview-vat-status-change

Query parameters

effectiveFromstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
vatPayer"true" | "false"required

Response · 200

effectiveFromnull | stringrequireddate
vatPayerbooleanrequired
documentsToReviewobject[]required
idstringrequired
numbernull | stringrequired
taxPointDatenull | stringrequireddate
totalHalerinteger | nullrequired
section79object
rulestringrequired
rowintegerrequired
candidatesany[]required
totalVatHalerintegerrequired
section79aobject
rulestringrequired
rowintegerrequired
assetsany[]required
stockValueHalerintegerrequired
GET/v1/tax/vat-status/review
curl https://api.damedoklad.cz/v1/tax/vat-status/review \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Say the company has no seat in the Czech Republic: § 6c then replaces the turnover limits of § 6, the first taxable supply here makes it a payer

PUT/v1/tax/vat-status/seat

Say the company has no seat in the Czech Republic: § 6c then replaces the turnover limits of § 6, the first taxable supply here makes it a payer

MCP tool: set-vat-seat-abroad

Request body

seatAbroadbooleanrequired

Response · 200

vatPayerbooleanrequired
vatPeriodstringrequired
dicnull | stringrequired
historyobject[]required
fromnull | stringrequireddate
vatPayerbooleanrequired
vatPeriodstringrequired
notenull | stringrequired
payerSincenull | stringrequireddate
seatAbroadbooleanrequired
identifiedFromnull | stringrequireddate
PUT/v1/tax/vat-status/seat
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-status/seat \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "seatAbroad": false
}'

Obrat pro DPH (§ 4a, § 6 ZDPH): the calendar year by month, the 2 000 000 and 2 536 500 Kč limits, the day each was exceeded, and when the application is due

GET/v1/tax/vat-turnover

Obrat pro DPH (§ 4a, § 6 ZDPH): the calendar year by month, the 2 000 000 and 2 536 500 Kč limits, the day each was exceeded, and when the application is due. A warning for a person to check: supplies with a place of supply abroad are left out by VAT mode, and sales of long-term assets by account 641. Whatever the documents cannot show goes in as an adjustment.

MCP tool: get-vat-turnover

Query parameters

yearintegermin 2000max 2100

Response · 200

yearintegerrequired
turnoverHalerintegerrequired
limitHalerintegerrequired
fastLimitHalerintegerrequired
remainingHalerinteger | nullrequired
percentinteger | nullrequired
statusstringrequired
annualExceededOnnull | stringrequireddate
fastExceededOnanyrequired
Null in every recorded response.
previousYearHaleranyrequired
Null in every recorded response.
dutynull | objectrequired
rulestringrequired
payerFromstringrequireddate
applicationDuestringrequireddate
earlierFromstringdate
seatAbroadboolean
mayDeregisterbooleanrequired
monthsobject[]required
monthinteger | nullrequired
amountHalerinteger | nullrequired
cumulativeHalerintegerrequired
vatPayerbooleanrequired
bySourceobjectrequired
invoiceinteger
credit_noteinteger
journalinteger
adjustmentinteger
adjustmentsobject[]required
object"vat_turnover_adjustment"required
idstringrequired
datestringrequireddate
amountHalerinteger | nullrequired
notenull | stringrequired
seatAbroadboolean
inGroupboolean
GET/v1/tax/vat-turnover
curl https://api.damedoklad.cz/v1/tax/vat-turnover \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add to or take from the turnover: sales before this app, or a supply that § 4a does not count

POST/v1/tax/vat-turnover/adjustments

Add to or take from the turnover: sales before this app, or a supply that § 4a does not count

MCP tool: create-vat-turnover-adjustment

Request body

datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
amountHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
notestringrequiredmax 240 chars

Response · 201

idstringrequired
datestringrequireddate
amountHalerinteger | nullrequired
notenull | stringrequired
POST/v1/tax/vat-turnover/adjustments
curl -X POST https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "amountHaler": 1210000,
  "note": "string"
}'

Remove a turnover adjustment

DELETE/v1/tax/vat-turnover/adjustments/{id}

Remove a turnover adjustment

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-vat-turnover-adjustment

Path parameters

idstringrequired

Response · 200

idstringrequired
datestringrequireddate
amountHalerinteger | nullrequired
notenull | stringrequired
DELETE/v1/tax/vat-turnover/adjustments/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Items for VAT return rows 45, 47, 51, 60 and 61 in a period, with their effect on the row

GET/v1/tax/vat/adjustments

Items for VAT return rows 45, 47, 51, 60 and 61 in a period, with their effect on the row

MCP tool: list-tax-vat-adjustments

Query parameters

yearintegermin 2016max 2100
monthintegermin 1max 12
quarterintegermin 1max 4
limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"tax_vat_adjustment"required
idstringrequired
kindstringrequired
reportDatestringrequireddate
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
valueHalerinteger | nullrequired
reducedDeductionbooleanrequired
inputsobjectrequired
carLimitboolean
yearsinteger
inputVatHalerinteger
currentPercentinteger
originalPercentinteger
carAcquiredOnstringdate
notenull | stringrequired
effectobjectrequired
rowintegerrequired
valuesobjectrequired
fullinteger
baseinteger
deductibleinteger
valueinteger
createdAtstringrequireddate-time
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/vat/adjustments
curl https://api.damedoklad.cz/v1/tax/vat/adjustments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add an item to VAT return row 45, 47, 51, 60 or 61, for example a § 77 settlement or a § 78 adjustment

POST/v1/tax/vat/adjustments

Add an item to VAT return row 45, 47, 51, 60 or 61, for example a § 77 settlement or a § 78 adjustment

MCP tool: create-tax-vat-adjustment

Request body

kind"s75_correction" | "s77_settlement" | "s77a_car" | "s79_registration" | "s4_long_term_asset" | "s76_excluded_taxable" | "s76_excluded_exempt" | "s78_adjustment" | "s78_oneoff" | "s84_refund"required
reportDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
baseHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
valueHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
reducedDeductionboolean
inputsobject
inputVatHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
years5 | 10
originalPercentnumbermin 0max 100
currentPercentnumbermin 0max 100
carLimitboolean
carPriorVatHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
carAcquiredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
notestringmax 2000 chars

Response · 201

idstringrequired
kindstringrequired
reportDatestringrequireddate
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
valueHalerinteger | nullrequired
reducedDeductionbooleanrequired
inputsobjectrequired
carLimitboolean
yearsinteger
inputVatHalerinteger
currentPercentinteger
originalPercentinteger
carAcquiredOnstringdate
notenull | stringrequired
effectobjectrequired
rowintegerrequired
valuesobjectrequired
fullinteger
baseinteger
deductibleinteger
valueinteger
createdAtstringrequireddate-time
POST/v1/tax/vat/adjustments
curl -X POST https://api.damedoklad.cz/v1/tax/vat/adjustments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "s75_correction",
  "reportDate": "2026-10-30"
}'

Delete an item from VAT return row 45, 47, 51, 60 or 61

DELETE/v1/tax/vat/adjustments/{id}

Delete an item from VAT return row 45, 47, 51, 60 or 61

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-tax-vat-adjustment

Path parameters

idstringrequired

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/tax/vat/adjustments/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

One document as the VAT evidence sees it: classification, default treatment, return rows and KH section

GET/v1/tax/vat/documents/{type}/{id}

One document as the VAT evidence sees it: classification, default treatment, return rows and KH section

MCP tool: get-vat-document-detail

Path parameters

typestringrequired
idstringrequired

Response · 200

idstringrequired
documentTypenull | stringrequired
numbernull | stringrequired
vatModestring
statusstringrequired
taxPointDatenull | stringdate
contactNamenull | string
contactDicnull | string
totalHalerinteger | null
currencynull | string
exchangeRateinteger | nullrequired
defaultTreatmentstringrequired
classificationnull | objectrequired
treatmentstring | null
deductionnull | string
deductionPercentinteger | null
selfAssessRateinteger | null
reverseChargeCodestring | null
specialRegimeinteger
reportDatestring | null
evidenceNumberstring | null
partnerDicstring | null
partnerCountrystring | null
ossCountrystring | null
ossRatestring | null
ossRateTypestring | null
ossSupplyTypestring | null
ossSchemestring | null
carLimitboolean
carPriorVatHalerinteger | null
coefficientExcludedboolean
notestring | null
carInUseOnstring | null
entriesobject[]required
documentIdnull | stringrequired
documentTypenull | stringrequired
numbernull | stringrequired
evidenceNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
contactCountrystringrequired
datestringrequireddate
taxPointDatenull | stringrequireddate
treatmentnull | stringrequired
isDefaultTreatmentbooleanrequired
rateintegerrequired
bandstringrequired
columnintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
deductibleVatHalerintegerrequired
carLimitedbooleanrequired
coefficientExcludedbooleanrequired
deductionnull | stringrequired
deductionPercentinteger | nullrequired
reverseChargeCodestring | nullrequired
specialRegimeintegerrequired
documentTotalHalerintegerrequired
isBadDebtbooleanrequired
khGroupIdanyrequired
Null in every recorded response.
isDebtorCorrectionbooleanrequired
offLedgerbooleanrequired
isCorrectionbooleanrequired
ossCountrynull | stringrequired
ossRatestring | nullrequired
ossRateTypestring | nullrequired
ossSupplyTypestring | nullrequired
ossSchemestring | nullrequired
currencynull | stringrequired
documentNetHalerintegerrequired
returnRowsobjectrequired
rowLabelsobjectrequired
issuesany[]required
GET/v1/tax/vat/documents/{type}/{id}
curl https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Set the VAT classification of a document: treatment, deduction, § 92a code, reporting date, evidence number

PUT/v1/tax/vat/documents/{type}/{id}/classification

Set the VAT classification of a document: treatment, deduction, § 92a code, reporting date, evidence number

MCP tool: update-vat-classification

Path parameters

typestringrequired
idstringrequired

Request body

treatment"output_domestic" | "output_reverse_92a" | "output_eu_goods" | "output_eu_transfer" | "output_triangular" | "output_eu_services" | "output_export" | "output_new_vehicle" | "output_oss" | "output_other_deductible" | "output_gold" | "output_exempt" | "input_triangular" | "input_domestic" | "input_reverse_92a" | "input_eu_goods" | "input_eu_services" | "input_other_self_assessed" | "input_new_vehicle" | "input_import_self" | "input_import_customs" | "none" | null
deduction"full" | "proportional" | "coefficient" | "none" | null
deductionPercentinteger | null
selfAssessRateinteger | null
reverseChargeCodestring | null
specialRegimeintegermin 0max 2
reportDatestring | null
Date as YYYY-MM-DD.
evidenceNumberstring | null
partnerDicstring | null
VAT number (DIČ), for example CZ12345678.
partnerCountrystring | null
ossCountrystring | null
ossRatenumber | null
ossRateType"Z" | "S" | null
ossSupplyType"G" | "S" | null
ossScheme"EU" | "NON_EU" | "IMPORT" | null
carLimitboolean
carPriorVatHalerinteger | null
Integer amount in haléře: 100 = 1 Kč.
carInUseOnstring | null
Date as YYYY-MM-DD.
coefficientExcludedboolean
notestring | null

Response · 200

documentTypenull | stringrequired
documentIdnull | stringrequired
treatmentnull | stringrequired
deductionnull | stringrequired
deductionPercentinteger | nullrequired
selfAssessRateinteger | nullrequired
reverseChargeCodenull | stringrequired
specialRegimeintegerrequired
reportDatenull | stringrequireddate
evidenceNumberstring | nullrequired
partnerDicnull | stringrequired
partnerCountrystring | nullrequired
ossCountrynull | stringrequired
ossRateinteger | nullrequired
ossRateTypenull | stringrequired
ossSupplyTypenull | stringrequired
ossSchemenull | stringrequired
carLimitbooleanrequired
carPriorVatHalerinteger | nullrequired
coefficientExcludedbooleanrequired
notestring | nullrequired
carInUseOnnull | stringdate
PUT/v1/tax/vat/documents/{type}/{id}/classification
curl -X PUT https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "treatment": "output_domestic",
  "deduction": "full",
  "deductionPercent": 0
}'

Drop the manual classification of a document so the default from its VAT mode applies again

DELETE/v1/tax/vat/documents/{type}/{id}/classification

Drop the manual classification of a document so the default from its VAT mode applies again

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: reset-vat-classification

Path parameters

typestringrequired
idstringrequired

Response · 200

documentTypenull | stringrequired
documentIdnull | stringrequired
deletedbooleanrequired
DELETE/v1/tax/vat/documents/{type}/{id}/classification
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

VAT register for a period: every document with its classification, amounts, KH section and problems

GET/v1/tax/vat/register

VAT register for a period: every document with its classification, amounts, KH section and problems

MCP tool: get-vat-register

Query parameters

yearintegermin 2016max 2100
monthintegermin 1max 12
quarterintegermin 1max 4

Response · 200

periodobjectrequired
yearintegerrequired
monthinteger | nullrequired
keystringrequired
fromstringrequireddate
tostringrequireddate
dataobject[]required
object"tax_document"required
idstringrequired
documentTypenull | stringrequired
numbernull | stringrequired
evidenceNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
contactCountrystringrequired
datestringrequireddate
taxPointDatenull | stringrequireddate
treatmentnull | stringrequired
isDefaultTreatmentbooleanrequired
deductionnull | stringrequired
deductionPercentinteger | nullrequired
reverseChargeCodenull | stringrequired
khSectionnull | stringrequired
isAdvancebooleanrequired
isBadDebtbooleanrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
ratesobject[]required
rateintegerrequired
baseHalerinteger | nullrequired
vatHalerinteger | nullrequired
flagsobject[]required
codenull | stringrequired
messagenull | stringrequired
notestring | nullrequired
totalintegerrequired
hasMorebooleanrequired
reconciliationnull | objectrequired
expectedOutputHalerintegerrequired
expectedInputHalerintegerrequired
journalOutputHalerintegerrequired
journalInputHalerintegerrequired
offLedgerVatHalerintegerrequired
nonDeductibleHalerintegerrequired
outputDifferenceHalerintegerrequired
inputDifferenceHalerintegerrequired
balancedbooleanrequired
differencesobject[]required
documentIdnull | stringrequired
documentTypenull | stringrequired
isDebtorCorrectionbooleanrequired
numbernull | stringrequired
documentVatHalerintegerrequired
journalVatHalerintegerrequired
unmatchedobject[]required
debitHalerintegerrequired
creditHalerintegerrequired
accountNumbernull | stringrequired
sourceOidstringrequired
sourceTypenull | stringrequired
sourceEventnull | stringrequired
sourceLineOidanyrequired
Null in every recorded response.
numberinteger | nullrequired
documentNumbernull | stringrequired
entryDatestringrequireddate
GET/v1/tax/vat/register
curl https://api.damedoklad.cz/v1/tax/vat/register \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Check an EU VAT number: its format here, then its validity in VIES

POST/v1/tax/vat/vies-check

Check an EU VAT number: its format here, then its validity in VIES

MCP tool: check-vies-number

Request body

vatIdstringrequiredmin 4 charsmax 16 chars
ID of the vat.

Response · 200

sourcestringrequired
checkedAtnull | stringdate-time
vatNumberstringrequired
validbooleanrequired
namenull | string
addressnull | string
wellFormedboolean
POST/v1/tax/vat/vies-check
curl -X POST https://api.damedoklad.cz/v1/tax/vat/vies-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vatId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

List TaxVehicles

GET/v1/tax/vehicles

List TaxVehicles

MCP tool: list-tax-vehicles

Query parameters

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.

Response · 200

dataany[]required
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/tax/vehicles
curl https://api.damedoklad.cz/v1/tax/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a TaxVehicle

POST/v1/tax/vehicles

Create a TaxVehicle

MCP tool: create-tax-vehicle

Request body

platestringrequiredmax 12 chars
namestring | null
category"M1" | "M2" | "M3" | "N1" | "N2" | "N3" | "O1" | "O2" | "O3" | "O4"required
bodyCodestring | null
axlesinteger | null
weightTonsnumberrequiredmax 999
airSuspensionboolean
specialPurposeboolean
specialPlateboolean
outOfServiceboolean
taxedFromstring | null
Date as YYYY-MM-DD.
taxedTostring | null
Date as YYYY-MM-DD.
exemptLetterstring | null
monthsExemptintegermin 0max 12
discountPercent0 | 25 | 50 | 75 | 90 | 100

Response · 201

idstringrequired
platestringrequired
namenull | stringrequired
categorystringrequired
bodyCodenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
airSuspensionbooleanrequired
specialPurposebooleanrequired
specialPlatebooleanrequired
outOfServicebooleanrequired
taxedFromnull | stringrequireddate
taxedTostring | nullrequired
exemptLetterstring | nullrequired
monthsExemptintegerrequired
discountPercentintegerrequired
POST/v1/tax/vehicles
curl -X POST https://api.damedoklad.cz/v1/tax/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plate": "string",
  "category": "M1",
  "weightTons": 1
}'

Update a TaxVehicle

PATCH/v1/tax/vehicles/{id}

Update a TaxVehicle

MCP tool: update-tax-vehicle

Path parameters

idstringrequired

Request body

platestringmax 12 chars
namestring | null
category"M1" | "M2" | "M3" | "N1" | "N2" | "N3" | "O1" | "O2" | "O3" | "O4"
bodyCodestring | null
axlesinteger | null
weightTonsnumbermax 999
airSuspensionboolean
specialPurposeboolean
specialPlateboolean
outOfServiceboolean
taxedFromstring | null
Date as YYYY-MM-DD.
taxedTostring | null
Date as YYYY-MM-DD.
exemptLetterstring | null
monthsExemptintegermin 0max 12
discountPercent0 | 25 | 50 | 75 | 90 | 100

Response · 200

idstringrequired
platestringrequired
namenull | stringrequired
categorystringrequired
bodyCodenull | stringrequired
axlesinteger | nullrequired
weightTonsintegerrequired
airSuspensionbooleanrequired
specialPurposebooleanrequired
specialPlatebooleanrequired
outOfServicebooleanrequired
taxedFromnull | stringrequireddate
taxedTostring | nullrequired
exemptLetterstring | nullrequired
monthsExemptintegerrequired
discountPercentintegerrequired
PATCH/v1/tax/vehicles/{id}
curl -X PATCH https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "category": "M1"
}'

Delete a TaxVehicle

DELETE/v1/tax/vehicles/{id}

Delete a TaxVehicle

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-tax-vehicle

Path parameters

idstringrequired

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/tax/vehicles/{id}
curl -X DELETE https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"