Skip to content

Travel and vehicles

Operations in the Travel and vehicles group.

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

List fuel purchases

GET/v1/fuel-purchases

List fuel purchases

MCP tool: list-fuel-purchases

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.
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Response · 200

dataobject[]required
object"vehicle_fuel_purchase"required
idstringrequired
vehicleIdstringrequired
purchasedOnstringrequireddate
quantityMilliintegerrequired
amountHalerintegerrequired
odometerinteger | null
vendornull | stringrequired
notenull | string
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/fuel-purchases
curl https://api.damedoklad.cz/v1/fuel-purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does

POST/v1/fuel-purchases

Record a fuel purchase for the fuel reconciliation; it does not post to the books, the receipt does

MCP tool: create-fuel-purchase

Request body

vehicleIdstringrequired
ID of the vehicle. Find it with list-vehicles.
purchasedOnstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
quantityMilliintegerrequiredmin 1max 9007199254740991
Integer thousandths: 1500 means 1.5.
amountHalerintegerrequiredmin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
odometerintegermin 0max 9007199254740991
vendorstringmax 500 chars
notestringmax 2000 chars

Response · 201

idstringrequired
vehicleIdstringrequired
purchasedOnstringrequireddate
quantityMilliintegerrequired
amountHalerintegerrequired
odometerinteger | null
vendornull | stringrequired
notenull | string
POST/v1/fuel-purchases
curl -X POST https://api.damedoklad.cz/v1/fuel-purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "purchasedOn": "2026-10-30",
  "quantityMilli": 1000,
  "amountHaler": 1210000
}'

Delete a fuel purchase

DELETE/v1/fuel-purchases/{id}

Delete a fuel purchase

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

MCP tool: delete-fuel-purchase

Path parameters

idstringrequired

Response · 200

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

Import a fuel card statement as CSV: date, litres, and amount with VAT required; plate, product, station, card, and odometer optional. dryRun only validates

POST/v1/fuel-purchases/import

Import a fuel card statement as CSV: date, litres, and amount with VAT required; plate, product, station, card, and odometer optional. dryRun only validates. Lines for anything but fuel, such as a car wash, are skipped and listed. Other headers go through columnMap. A purchase already recorded (same vehicle, date, litres, and amount) is skipped. It does not post to the books; the invoice from the card issuer does.

MCP tool: import-fuel-card

Request body

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
csvstringmax 4000000 chars
fileBase64stringmax 8000000 chars
File content encoded as base64.
columnMapobject
dryRunboolean

Response · 200

dryRunbooleanrequired
importedintegerrequired
validintegerrequired
duplicatesintegerrequired
skippedobject[]required
lineintegerrequired
productstringrequired
errorsobject[]required
lineintegerrequired
messagenull | stringrequired
totalQuantityMilliintegerrequired
totalAmountHalerintegerrequired
headersanyrequired
Null in every recorded response.
missinganyrequired
Null in every recorded response.
POST/v1/fuel-purchases/import
curl -X POST https://api.damedoklad.cz/v1/fuel-purchases/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "csv": "string",
  "fileBase64": "string"
}'

Logbook of a year for the tax authority as a PDF: all trips, monthly km, business share, fuel against the technical certificate, and odometer problems

GET/v1/logbook-export.pdf

Logbook of a year for the tax authority as a PDF: all trips, monthly km, business share, fuel against the technical certificate, and odometer problems. The Income Tax Act prescribes no form for a logbook. The taxpayer proves the expense (§ 92 odst. 3 daňového řádu), so the export states everything that proof rests on. Pass vehicleId for one vehicle.

MCP tool: export-logbook-for-authority-pdf

Query parameters

yearintegerrequiredmin 1990max 2100
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Response · 200

Returns a application/pdf file.

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

Logbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle

GET/v1/logbook-export.xlsx

Logbook of a year as an XLSX workbook: a summary sheet and one sheet of trips per vehicle

MCP tool: export-logbook-for-authority-xlsx

Query parameters

yearintegerrequiredmin 1990max 2100
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.

Response · 200

Returns a application/vnd.openxmlformats-officedocument.spreadsheetml.sheet file.

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

Paušální výdaj na dopravu for a year (§ 24 odst. 2 písm. zt) ZDP): 5 000 Kč per vehicle and month, 4 000 Kč when reduced. The tax module reads this

GET/v1/transport-flat-rate

Paušální výdaj na dopravu for a year (§ 24 odst. 2 písm. zt) ZDP): 5 000 Kč per vehicle and month, 4 000 Kč when reduced. The tax module reads this

MCP tool: get-transport-flat-rate

Query parameters

yearintegerrequiredmin 1990max 2100

Response · 200

yearintegerrequired
vehiclesobject[]required
vehicleIdstringrequired
modestringrequired
monthlyHalerintegerrequired
monthsobject[]required
monthinteger | nullrequired
daysintegerrequired
amountHalerinteger | nullrequired
amountHalerinteger | nullrequired
totalHalerinteger | nullrequired
reducedCountintegerrequired
monthlyHalerinteger
reducedPctinteger
maxVehiclesinteger
GET/v1/transport-flat-rate
curl https://api.damedoklad.cz/v1/transport-flat-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Choose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none

PUT/v1/transport-flat-rate

Choose the transport flat rate of a vehicle for a year: full, reduced (also private use), or none

MCP tool: set-transport-flat-rate

Request body

vehicleIdstringrequired
ID of the vehicle. Find it with list-vehicles.
yearintegerrequiredmin 1990max 2100
mode"full" | "reduced" | "none"required
validFromstringYYYY-MM-DD
Date as YYYY-MM-DD.
validTostringYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

yearintegerrequired
vehiclesobject[]required
vehicleIdstringrequired
modestringrequired
monthlyHalerintegerrequired
monthsobject[]required
monthinteger | nullrequired
daysintegerrequired
amountHalerinteger | nullrequired
amountHalerinteger | nullrequired
totalHalerinteger | nullrequired
reducedCountintegerrequired
monthlyHalerinteger
reducedPctinteger
maxVehiclesinteger
PUT/v1/transport-flat-rate
curl -X PUT https://api.damedoklad.cz/v1/transport-flat-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "year": 2026,
  "mode": "full"
}'

Employees that a business trip can be linked to: id and name only

GET/v1/travel-employees

Employees that a business trip can be linked to: id and name only

MCP tool: list-travel-employees

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"travel_employee"required
idstringrequired
namenull | stringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/travel-employees
curl https://api.damedoklad.cz/v1/travel-employees \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List business trip orders (cestovní příkazy)

GET/v1/travel-orders

List business trip orders (cestovní příkazy)

MCP tool: list-travel-orders

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
status"draft" | "settled" | "paid"

Response · 200

dataobject[]required
object"travel_order"required
idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/travel-orders
curl https://api.damedoklad.cz/v1/travel-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a domestic or foreign business trip order; add abroad segments and expenses to it

POST/v1/travel-orders

Create a domestic or foreign business trip order; add abroad segments and expenses to it

MCP tool: create-travel-order

Request body

travelerNamestringmax 200 chars
employeeIdstring | null
ID of the employee.
interruptionsobject[]
fromAtstringrequired
toAtstringrequired
familyVisitsobject[]
fromAtstringrequired
toAtstringrequired
fareHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
limitHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
fareCentsintegermin 0max 9007199254740991
limitCentsintegermin 0max 9007199254740991
familyVisitAgreedboolean
agreedMealsobject
tier5to12integermin 0max 9007199254740991
tier12to18integermin 0max 9007199254740991
over18integermin 0max 9007199254740991
mealCutsobject
tier5to12numbermin 0max 70
tier12to18numbermin 0max 35
over18numbermin 0max 25
foreignRatePctinteger | null
fareEquivalentHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
travelerKind"employee" | "owner"
purposestringrequiredmax 200 chars
destinationstringrequiredmax 200 chars
startAtstringrequired
endAtstringrequired
transport"public" | "company_car" | "private_car" | "equivalent" | "other"
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
trailerboolean
documentedFuelPriceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
basicRateHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
pocketMoneyPctintegermin 0max 40
freeMealsobject
exchangeRatesobject
advanceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
abroadobject[]
countryCodestringrequiredmin 2 charsmax 20 chars
fromAtstringrequired
toAtstringrequired
expensesobject[]
kind"accommodation" | "transport" | "parking" | "other"
descriptionstringmax 500 chars
amountCentsintegerrequiredmin 0max 9007199254740991
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
vatHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
notestringmax 2000 chars

Response · 201

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders
curl -X POST https://api.damedoklad.cz/v1/travel-orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "purpose": "string",
  "destination": "string",
  "startAt": "2026-10-30T08:00",
  "endAt": "2026-10-30T08:00"
}'

Get a business trip order with its time abroad and expenses

GET/v1/travel-orders/{id}

Get a business trip order with its time abroad and expenses

MCP tool: get-travel-order

Path parameters

idstringrequired

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
GET/v1/travel-orders/{id}
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Edit a business trip order before it is settled

PATCH/v1/travel-orders/{id}

Edit a business trip order before it is settled

MCP tool: update-travel-order

Path parameters

idstringrequired

Request body

travelerNamestringmax 200 chars
employeeIdstring | null
ID of the employee.
interruptionsobject[]
fromAtstringrequired
toAtstringrequired
familyVisitsobject[]
fromAtstringrequired
toAtstringrequired
fareHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
limitHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
fareCentsintegermin 0max 9007199254740991
limitCentsintegermin 0max 9007199254740991
familyVisitAgreedboolean
agreedMealsobject
tier5to12integermin 0max 9007199254740991
tier12to18integermin 0max 9007199254740991
over18integermin 0max 9007199254740991
mealCutsobject
tier5to12numbermin 0max 70
tier12to18numbermin 0max 35
over18numbermin 0max 25
foreignRatePctinteger | null
fareEquivalentHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
travelerKind"employee" | "owner"
purposestringmax 200 chars
destinationstringmax 200 chars
startAtstring
endAtstring
transport"public" | "company_car" | "private_car" | "equivalent" | "other"
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
trailerboolean
documentedFuelPriceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
basicRateHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
pocketMoneyPctintegermin 0max 40
freeMealsobject
exchangeRatesobject
advanceHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
abroadobject[]
countryCodestringrequiredmin 2 charsmax 20 chars
fromAtstringrequired
toAtstringrequired
expensesobject[]
kind"accommodation" | "transport" | "parking" | "other"
descriptionstringmax 500 chars
amountCentsintegerrequiredmin 0max 9007199254740991
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
vatHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
notestringmax 2000 chars

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
PATCH/v1/travel-orders/{id}
curl -X PATCH https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "travelerName": "Pekárna U Lípy s.r.o.",
  "employeeId": "yee_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "interruptions": [
    {
      "fromAt": "2026-10-30T08:00",
      "toAt": "2026-10-30T08:00"
    }
  ]
}'

Delete a business trip order that has not been settled and has no paid advance

DELETE/v1/travel-orders/{id}

Delete a business trip order that has not been settled and has no paid advance

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

MCP tool: delete-travel-order

Path parameters

idstringrequired

Response · 200

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

Pay out the trip advance: MD 335 / D 211xxx or 221xxx, or a non-tax cash book row. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over. A movement can also pay it directly (POST /bank-movements/{id}/match with kind travel_advance)

POST/v1/travel-orders/{id}/advance

Pay out the trip advance: MD 335 / D 211xxx or 221xxx, or a non-tax cash book row. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over. A movement can also pay it directly (POST /bank-movements/{id}/match with kind travel_advance)

MCP tool: pay-travel-advance

Path parameters

idstringrequired

Request body

datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
method"transfer" | "cash" | "card"
registerIdstring
ID of the register.
bankAccountIdstring
ID of the bank account. Find it with list-bank-accounts.
amountHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders/{id}/advance
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/advance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Download a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines

GET/v1/travel-orders/{id}/order.pdf

Download a business trip order as a PDF: the trip, the settlement by day, expenses, the balance, and signature lines

MCP tool: export-travel-order-pdf

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

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

Pay the reimbursement (MD 333 / D 221xxx or 211xxx) or take back an overpaid advance (MD 211xxx or 221xxx / D 335), rounded up to whole koruny. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over

POST/v1/travel-orders/{id}/pay

Pay the reimbursement (MD 333 / D 221xxx or 211xxx) or take back an overpaid advance (MD 211xxx or 221xxx / D 335), rounded up to whole koruny. Cash comes from a register; a transfer from a bank account, and a later statement line takes it over

MCP tool: pay-travel-order

Path parameters

idstringrequired

Request body

datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
method"transfer" | "cash" | "card"
registerIdstring
ID of the register.
bankAccountIdstring
ID of the bank account. Find it with list-bank-accounts.

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders/{id}/pay
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pay \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Pay a settled trip through the payroll of a month: the amount joins the wage payment, untaxed, and the order is paid when the run locks

POST/v1/travel-orders/{id}/payroll

Pay a settled trip through the payroll of a month: the amount joins the wage payment, untaxed, and the order is paid when the run locks. Needs an employee on the order with a contract in that month. Payroll posts MD 333 / D 331 when the run locks. A draft or reviewed run is recalculated, and a reviewed one returns to draft.

MCP tool: queue-travel-reimbursement

Path parameters

idstringrequired

Request body

yearintegerrequiredmin 1990max 2100
monthintegerrequiredmin 1max 12

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders/{id}/payroll
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payroll \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "month": 1
}'

Take a trip back out of a payroll run that is not locked yet

POST/v1/travel-orders/{id}/payroll/cancel

Take a trip back out of a payroll run that is not locked yet

MCP tool: cancel-travel-reimbursement

Path parameters

idstringrequired

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders/{id}/payroll/cancel
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payroll/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Which ČNB rates a trip needs and for which date (§ 183 odst. 2, § 184 of the Labour Code). Get them from /ledger/exchange-rates/lookup and PATCH them into exchangeRates

GET/v1/travel-orders/{id}/required-rates

Which ČNB rates a trip needs and for which date (§ 183 odst. 2, § 184 of the Labour Code). Get them from /ledger/exchange-rates/lookup and PATCH them into exchangeRates

MCP tool: get-travel-order-required-rates

Path parameters

idstringrequired

Response · 200

orderIdnull | stringrequired
datestringrequireddate
currenciesobject[]required
currencynull | stringrequired
ratenull | numberrequired
GET/v1/travel-orders/{id}/required-rates
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/required-rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Settle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335

POST/v1/travel-orders/{id}/settle

Settle a business trip: MD 512 + 343 / D 333 and the advance cleared MD 333 / D 335

MCP tool: settle-travel-order

Path parameters

idstringrequired

Request body

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

Response · 200

idstringrequired
numberstringrequired
travelerNamestringrequired
travelerKindstringrequired
purposestringrequired
destinationstringrequired
startAtstringrequired
endAtstringrequired
transportstringrequired
vehicleIdnull | stringrequired
kmMilliintegerrequired
trailerbooleanrequired
documentedFuelPriceHalerinteger | nullrequired
basicRateHalerinteger | nullrequired
pocketMoneyPctintegerrequired
freeMealsobjectrequired
exchangeRatesobjectrequired
advanceHalerintegerrequired
advancePaidOnnull | stringrequireddate
statusstringrequired
totalHalerintegerrequired
settleHalerintegerrequired
settledOnnull | stringrequireddate
paidOnnull | stringrequireddate
notestring | nullrequired
employeeIdnull | stringrequired
interruptionsobject[]required
toAtstringrequired
fromAtstringrequired
familyVisitsobject[]required
toAtstringrequired
fromAtstringrequired
fareHalerinteger
limitHalerinteger
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitAgreedbooleanrequired
agreedMealsobjectrequired
tier5to12integer
mealCutsobjectrequired
tier12to18integer
foreignRatePctinteger | nullrequired
fareEquivalentHalerintegerrequired
payMethodnull | stringrequired
payrollYearinteger | nullrequired
payrollMonthinteger | nullrequired
settlementnull | objectrequired
daysobject[]required
datestringrequireddate
tiernull | stringrequired
foreignnull | objectrequired
currencynull | stringrequired
baseAmountintegerrequired
grossCentsintegerrequired
amountCentsintegerrequired
countryCodenull | stringrequired
countryNamestringrequired
fractionThirdsintegerrequired
reductionCentsintegerrequired
freeMealsintegerrequired
grossHalerintegerrequired
amountHalerinteger | nullrequired
abroadMinutesintegerrequired
reductionHalerintegerrequired
domesticMinutesintegerrequired
taxableExcessHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
fuelHalerintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
totalHalerintegerrequired
consumedMilliintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
expensesobject[]required
kindstringrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountCentsintegerrequired
amountHalerinteger | nullrequired
descriptionnull | stringrequired
vatHalerinteger | nullrequired
warningsany[]required
totalHalerintegerrequired
settleHalerintegerrequired
advanceHalerintegerrequired
familyVisitsobject[]required
tostringrequired
fromstringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
mileageHalerintegerrequired
expensesHalerintegerrequired
roundingHalerintegerrequired
familyVisitHalerintegerrequired
foreignMealHalerintegerrequired
pocketMoneyHalerintegerrequired
domesticMealHalerintegerrequired
foreignByCurrencyobjectrequired
taxableExcessHalerintegerrequired
fareEquivalentHalerintegerrequired
abroadobject[]
countryCodenull | stringrequired
fromAtstringrequired
toAtstringrequired
expensesobject[]
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
POST/v1/travel-orders/{id}/settle
curl -X POST https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

Compute the settlement of a business trip without posting: stravné by day, mileage, expenses, advance, and the amount to pay

GET/v1/travel-orders/{id}/settlement-preview

Compute the settlement of a business trip without posting: stravné by day, mileage, expenses, advance, and the amount to pay

MCP tool: preview-travel-settlement

Path parameters

idstringrequired

Response · 200

orderIdnull | stringrequired
daysobject[]required
datestringrequireddate
domesticMinutesintegerrequired
abroadMinutesintegerrequired
tiernull | stringrequired
freeMealsintegerrequired
grossHalerintegerrequired
reductionHalerintegerrequired
amountHalerinteger | nullrequired
taxableExcessHalerintegerrequired
foreignnull | objectrequired
countryCodenull | stringrequired
countryNamestringrequired
currencynull | stringrequired
baseAmountintegerrequired
fractionThirdsintegerrequired
grossCentsintegerrequired
reductionCentsintegerrequired
amountCentsintegerrequired
domesticMealHalerintegerrequired
foreignMealHalerintegerrequired
foreignByCurrencyobjectrequired
pocketMoneyHalerintegerrequired
mileageHalerintegerrequired
fareEquivalentHalerintegerrequired
familyVisitsobject[]required
fromstringrequired
tostringrequired
fareHalerintegerrequired
limitHalerintegerrequired
amountHalerinteger | nullrequired
currencynull | string
fareCentsinteger
limitCentsinteger
familyVisitHalerintegerrequired
warningsany[]required
taxableExcessHalerintegerrequired
expensesHalerintegerrequired
expensesobject[]required
kindstringrequired
descriptionnull | stringrequired
amountCentsintegerrequired
currencynull | stringrequired
vatHalerinteger | nullrequired
amountHalerinteger | nullrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
advanceHalerintegerrequired
settleHalerintegerrequired
roundingHalerintegerrequired
mileagenull | objectrequired
kmMilliintegerrequired
rateHalerintegerrequired
basicHalerintegerrequired
fuelPriceHalerintegerrequired
fuelPriceSourcestringrequired
consumedMilliintegerrequired
fuelHalerintegerrequired
totalHalerinteger | nullrequired
GET/v1/travel-orders/{id}/settlement-preview
curl https://api.damedoklad.cz/v1/travel-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settlement-preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Statutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems

GET/v1/travel-rates

Statutory travel rates of a year: mileage, meal allowance, average fuel prices, and foreign per diems

MCP tool: get-travel-rates

Query parameters

yearintegermin 1990max 2100

Response · 200

yearintegerrequired
citationstringrequired
mileageHalerobjectrequired
motorcycleintegerrequired
carintegerrequired
mealsHalerobjectrequired
tier5to12integerrequired
tier12to18integerrequired
over18integerrequired
mealsMaxHalerobjectrequired
tier5to12integerrequired
tier12to18integerrequired
over18integerrequired
fuelHalerobject[]required
fromstringrequireddate
ba95integerrequired
ba98integerrequired
dieselintegerrequired
electricityintegerrequired
foreignobject[]required
countryCodenull | stringrequired
namenull | stringrequired
currencynull | stringrequired
baseAmountintegerrequired
GET/v1/travel-rates
curl https://api.damedoklad.cz/v1/travel-rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List logbook trips, filterable by vehicle, type, and date

GET/v1/trips

List logbook trips, filterable by vehicle, type, and date

MCP tool: list-trips

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.
vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
tripType"business" | "private"

Response · 200

dataobject[]required
object"vehicle_trip"required
idstringrequired
vehicleIdstringrequired
routeIdnull | stringrequired
datestringrequireddate
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
drivernull | stringrequired
odometerStartinteger | nullrequired
odometerEndinteger | nullrequired
notestring | null
continuityIssuesobject[]
idstringrequired
datestringrequireddate
kindstringrequired
expectedintegerrequired
actualintegerrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/trips
curl https://api.damedoklad.cz/v1/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add a logbook trip. Pass routeId to fill it from a recurring route; the odometer continues from the last trip

POST/v1/trips

Add a logbook trip. Pass routeId to fill it from a recurring route; the odometer continues from the last trip. The trip is saved even when the odometer does not chain, since unrecorded private driving happens. The response lists any problem in continuityIssues.

MCP tool: create-trip

Request body

vehicleIdstringrequired
ID of the vehicle. Find it with list-vehicles.
routeIdstring
ID of the route.
datestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"
driverstringmax 500 chars
odometerStartintegermin 0max 9007199254740991
odometerEndintegermin 0max 9007199254740991
notestringmax 2000 chars

Response · 201

idstringrequired
vehicleIdstringrequired
routeIdnull | stringrequired
datestringrequireddate
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
drivernull | stringrequired
odometerStartinteger | nullrequired
odometerEndinteger | nullrequired
notestring | null
continuityIssuesobject[]
idstringrequired
datestringrequireddate
kindstringrequired
expectedintegerrequired
actualintegerrequired
POST/v1/trips
curl -X POST https://api.damedoklad.cz/v1/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "date": "2026-10-30"
}'

Correct a logbook trip

PATCH/v1/trips/{id}

Correct a logbook trip

MCP tool: update-trip

Path parameters

idstringrequired

Request body

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
routeIdstring
ID of the route.
datestringYYYY-MM-DD
Date as YYYY-MM-DD.
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"
driverstringmax 500 chars
odometerStartintegermin 0max 9007199254740991
odometerEndintegermin 0max 9007199254740991
notestringmax 2000 chars

Response · 200

idstringrequired
vehicleIdstringrequired
routeIdnull | stringrequired
datestringrequireddate
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
drivernull | stringrequired
odometerStartinteger | nullrequired
odometerEndinteger | nullrequired
notestring | null
continuityIssuesobject[]
idstringrequired
datestringrequireddate
kindstringrequired
expectedintegerrequired
actualintegerrequired
PATCH/v1/trips/{id}
curl -X PATCH https://api.damedoklad.cz/v1/trips/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "routeId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "date": "2026-10-30"
}'

Delete a logbook trip

DELETE/v1/trips/{id}

Delete a logbook trip

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

MCP tool: delete-trip

Path parameters

idstringrequired

Response · 200

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

Import logbook trips from a CSV or fleet export (date, from, to, km required; purpose, type, driver, odometer, plate optional). dryRun only validates

POST/v1/trips/import

Import logbook trips from a CSV or fleet export (date, from, to, km required; purpose, type, driver, odometer, plate optional). dryRun only validates. Columns are found by name in Czech or English. For other headers pass columnMap, such as { "date": "Kdy" }; the answer lists headers and missing when it cannot find them. Without vehicleId the plate column picks the vehicle. A trip already in the logbook (same vehicle, date, route, and km) is skipped.

MCP tool: import-trips

Request body

vehicleIdstring
ID of the vehicle. Find it with list-vehicles.
csvstringmax 4000000 chars
fileBase64stringmax 8000000 chars
File content encoded as base64.
columnMapobject
dryRunboolean

Response · 200

dryRunbooleanrequired
importedintegerrequired
validintegerrequired
duplicatesintegerrequired
errorsobject[]required
lineintegerrequired
messagenull | stringrequired
continuityIssuesany[]required
headersarray | nullrequired
missingarray | nullrequired
POST/v1/trips/import
curl -X POST https://api.damedoklad.cz/v1/trips/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "csv": "string",
  "fileBase64": "string"
}'

List VehicleRoutes

GET/v1/vehicle-routes

List VehicleRoutes

MCP tool: list-vehicle-routes

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"vehicle_route"required
idstringrequired
namestringrequired
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/vehicle-routes
curl https://api.damedoklad.cz/v1/vehicle-routes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a VehicleRoute

POST/v1/vehicle-routes

Create a VehicleRoute

MCP tool: create-vehicle-route

Request body

namestringrequiredmax 200 chars
fromPlacestringrequiredmax 200 chars
toPlacestringrequiredmax 200 chars
purposestringmax 500 chars
kmMilliintegerrequiredmin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"

Response · 201

idstringrequired
namestringrequired
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
POST/v1/vehicle-routes
curl -X POST https://api.damedoklad.cz/v1/vehicle-routes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "fromPlace": "string",
  "toPlace": "string",
  "kmMilli": 1000
}'

Get a VehicleRoute

GET/v1/vehicle-routes/{id}

Get a VehicleRoute

MCP tool: get-vehicle-route

Path parameters

idstringrequired

Response · 200

idstringrequired
namestringrequired
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
GET/v1/vehicle-routes/{id}
curl https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Update a VehicleRoute

PATCH/v1/vehicle-routes/{id}

Update a VehicleRoute

MCP tool: update-vehicle-route

Path parameters

idstringrequired

Request body

namestringmax 200 chars
fromPlacestringmax 200 chars
toPlacestringmax 200 chars
purposestringmax 500 chars
kmMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
tripType"business" | "private"

Response · 200

idstringrequired
namestringrequired
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
PATCH/v1/vehicle-routes/{id}
curl -X PATCH https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "fromPlace": "string",
  "toPlace": "string"
}'

Delete a VehicleRoute

DELETE/v1/vehicle-routes/{id}

Delete a VehicleRoute

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

MCP tool: delete-vehicle-route

Path parameters

idstringrequired

Response · 200

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

Fill the logbook from a recurring route without GPS: one trip for each listed date or weekday in a period, optionally there and back

POST/v1/vehicle-routes/{id}/trips

Fill the logbook from a recurring route without GPS: one trip for each listed date or weekday in a period, optionally there and back. Pass dates, or from and to with weekdays (1 Monday to 7 Sunday, default Monday to Friday). Odometer readings chain from the vehicle’s last trip. Dates where this route is already in the logbook are skipped. dryRun only returns the trips.

MCP tool: generate-trips-from-route

Path parameters

idstringrequired

Request body

vehicleIdstringrequired
ID of the vehicle. Find it with list-vehicles.
datesstring[]
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
weekdaysinteger[]
skipstring[]
roundTripboolean
driverstringmax 500 chars
dryRunboolean

Response · 200

dryRunbooleanrequired
createdintegerrequired
skippedDatesstring[]required
lastOdometerintegerrequired
tripsobject[]required
object"vehicle_trip"required
idstringrequired
vehicleIdstringrequired
routeIdnull | stringrequired
datestringrequireddate
fromPlacestringrequired
toPlacestringrequired
purposenull | stringrequired
kmMilliintegerrequired
tripTypestringrequired
drivernull | stringrequired
odometerStartinteger | nullrequired
odometerEndinteger | nullrequired
notestring | null
continuityIssuesobject[]
idstringrequired
datestringrequireddate
kindstringrequired
expectedintegerrequired
actualintegerrequired
POST/v1/vehicle-routes/{id}/trips
curl -X POST https://api.damedoklad.cz/v1/vehicle-routes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/trips \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicleId": "tvh_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

List Vehicles

GET/v1/vehicles

List Vehicles

MCP tool: list-vehicles

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"vehicle"required
idstringrequired
registrationPlatestringrequired
namestringrequired
kindstringrequired
categorynull | stringrequired
fuelstringrequired
ownershipstringrequired
odometerStartintegerrequired
consumptionMilliintegerrequired
vinnull | stringrequired
firstRegisteredOnstring | nullrequired
grossWeightKginteger | nullrequired
axlesinteger | nullrequired
engineCcinteger | nullrequired
roadTaxRelevantbooleanrequired
assetIdnull | stringrequired
isActivebooleanrequired
notestring | nullrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/vehicles
curl https://api.damedoklad.cz/v1/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a Vehicle

POST/v1/vehicles

Create a Vehicle

MCP tool: create-vehicle

Request body

registrationPlatestringrequiredmax 20 chars
namestringrequiredmax 200 chars
kind"car" | "motorcycle" | "truck" | "bus" | "tractor"
categorystringmax 10 chars
fuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"required
ownership"company" | "private" | "leased"
odometerStartintegermin 0max 9007199254740991
consumptionMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
vinstringmax 40 chars
firstRegisteredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
grossWeightKgintegermin 0max 9007199254740991
axlesintegermin 0max 20
engineCcintegermin 0max 9007199254740991
roadTaxRelevantboolean
assetIdstring
ID of the asset. Find it with list-assets.
isActiveboolean
notestringmax 2000 chars

Response · 201

idstringrequired
registrationPlatestringrequired
namestringrequired
kindstringrequired
categorynull | stringrequired
fuelstringrequired
ownershipstringrequired
odometerStartintegerrequired
consumptionMilliintegerrequired
vinnull | stringrequired
firstRegisteredOnstring | nullrequired
grossWeightKginteger | nullrequired
axlesinteger | nullrequired
engineCcinteger | nullrequired
roadTaxRelevantbooleanrequired
assetIdnull | stringrequired
isActivebooleanrequired
notestring | nullrequired
POST/v1/vehicles
curl -X POST https://api.damedoklad.cz/v1/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registrationPlate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "fuel": "ba95"
}'

Get a Vehicle

GET/v1/vehicles/{id}

Get a Vehicle

MCP tool: get-vehicle

Path parameters

idstringrequired

Response · 200

idstringrequired
registrationPlatestringrequired
namestringrequired
kindstringrequired
categorynull | stringrequired
fuelstringrequired
ownershipstringrequired
odometerStartintegerrequired
consumptionMilliintegerrequired
vinnull | stringrequired
firstRegisteredOnstring | nullrequired
grossWeightKginteger | nullrequired
axlesinteger | nullrequired
engineCcinteger | nullrequired
roadTaxRelevantbooleanrequired
assetIdnull | stringrequired
isActivebooleanrequired
notestring | nullrequired
GET/v1/vehicles/{id}
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Update a Vehicle

PATCH/v1/vehicles/{id}

Update a Vehicle

MCP tool: update-vehicle

Path parameters

idstringrequired

Request body

registrationPlatestringmax 20 chars
namestringmax 200 chars
kind"car" | "motorcycle" | "truck" | "bus" | "tractor"
categorystringmax 10 chars
fuel"ba95" | "ba98" | "diesel" | "electric" | "lpg" | "cng" | "hybrid" | "other"
ownership"company" | "private" | "leased"
odometerStartintegermin 0max 9007199254740991
consumptionMilliintegermin 0max 9007199254740991
Integer thousandths: 1500 means 1.5.
vinstringmax 40 chars
firstRegisteredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
grossWeightKgintegermin 0max 9007199254740991
axlesintegermin 0max 20
engineCcintegermin 0max 9007199254740991
roadTaxRelevantboolean
assetIdstring
ID of the asset. Find it with list-assets.
isActiveboolean
notestringmax 2000 chars

Response · 200

idstringrequired
registrationPlatestringrequired
namestringrequired
kindstringrequired
categorynull | stringrequired
fuelstringrequired
ownershipstringrequired
odometerStartintegerrequired
consumptionMilliintegerrequired
vinnull | stringrequired
firstRegisteredOnstring | nullrequired
grossWeightKginteger | nullrequired
axlesinteger | nullrequired
engineCcinteger | nullrequired
roadTaxRelevantbooleanrequired
assetIdnull | stringrequired
isActivebooleanrequired
notestring | nullrequired
PATCH/v1/vehicles/{id}
curl -X PATCH https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registrationPlate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "kind": "car"
}'

Delete a Vehicle

DELETE/v1/vehicles/{id}

Delete a Vehicle

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

MCP tool: delete-vehicle

Path parameters

idstringrequired

Response · 200

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

Download the logbook of a vehicle as a PDF

GET/v1/vehicles/{id}/logbook.pdf

Download the logbook of a vehicle as a PDF

MCP tool: export-vehicle-logbook-pdf

Path parameters

idstringrequired

Query parameters

fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

Returns a application/pdf file.

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

Check the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven

GET/v1/vehicles/{id}/odometer-check

Check the odometer continuity of a vehicle: gaps, overlaps, and readings that disagree with the km driven

MCP tool: check-vehicle-odometer

Path parameters

idstringrequired

Response · 200

vehicleIdnull | stringrequired
okbooleanrequired
lastOdometerintegerrequired
issuesobject[]required
idstringrequired
datestringrequireddate
kindstringrequired
expectedintegerrequired
actualintegerrequired
GET/v1/vehicles/{id}/odometer-check
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/odometer-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Monthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate

GET/v1/vehicles/{id}/summary

Monthly logbook summary and fuel reconciliation of a vehicle for a year: km by type, purchased vs expected fuel from the technical certificate

MCP tool: get-vehicle-year-summary

Path parameters

idstringrequired

Query parameters

yearintegerrequiredmin 1990max 2100

Response · 200

vehicleIdnull | stringrequired
consumptionMilliintegerrequired
yearintegerrequired
monthsobject[]required
monthnull | stringrequired
businessKmMilliintegerrequired
privateKmMilliintegerrequired
tripsintegerrequired
fuelQuantityMilliintegerrequired
fuelAmountHalerintegerrequired
expectedFuelMilliintegerrequired
differenceMilliintegerrequired
totalsobjectrequired
businessKmMilliintegerrequired
privateKmMilliintegerrequired
tripsintegerrequired
fuelQuantityMilliintegerrequired
fuelAmountHalerintegerrequired
expectedFuelMilliintegerrequired
differenceMilliintegerrequired
actualConsumptionMilliintegerrequired
businessSharePctintegerrequired
GET/v1/vehicles/{id}/summary
curl https://api.damedoklad.cz/v1/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/summary \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"