Skip to content

Operations in the Contacts group.

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

List contact groups

GET/v1/contact-groups

List contact groups

MCP tool: list-contact-groups

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

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

Create a contact group

POST/v1/contact-groups

Create a contact group

MCP tool: create-contact-group

Request body

namestringrequiredmax 80 chars

Response · 201

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

List contacts (customers and suppliers), with what each one owes

GET/v1/contacts

List contacts (customers and suppliers), with what each one owes

MCP tool: list-contacts

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
qstringmax 200 chars
Older name for `search`.
rolesstring
customer, supplier, or both.
owing"true" | "false"
`true`: only contacts that owe you money.
restricted"true" | "false"
`true`: only contacts whose processing is restricted under GDPR. They are left out otherwise.
groupIdstring
Only contacts in this contact group.
customFieldKeystring
Only records with this custom field. Alone: it has any value. With customFieldValue: exactly that value, ignoring case.
customFieldValuestringmax 2000 chars

Response · 200

dataobject[]required
customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
object"contact"required
idstringrequired
kindstring
rolesstring
namestring
nameOnDocumentsstring | null
iconull | string
dicnull | string
vatPayerTypestring
emailnull | string
phonenull | string
mobilenull | string
wwwnull | string
notenull | string
dataBoxIdstring | null
externalCodenull | string
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethodstring | null
invoiceLanguagenull | string
defaultCurrencystring
creditWarnHalerinteger | null
creditBlockHalerinteger | null
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
unreliableVatPayerboolean | null
vatCheckedAtstring | null
viesValidboolean | null
viesCheckedAtstring | null
insolvencyStatusnull | string
insolvencyCheckedAtnull | stringdate-time
insolvencyProceedingsobject[]
iconull | stringrequired
urlstringrequired
namestringrequired
statestringrequired
activebooleanrequired
senatestringrequired
endedOnanyrequired
Null in every recorded response.
startedOnstringrequireddate
fileNumberstringrequired
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"required
idstringrequired
namestringrequired
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
bankAccountsobject[]
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
duplicateIcoobject
existingIdstringrequired
namestringrequired
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | string
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringrequired
overdueboolean
fileIdnull | stringrequired
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/contacts
curl https://api.damedoklad.cz/v1/contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a contact. Call lookup-ares first when you have an IČO, to fill in the official name, address, and DIČ

POST/v1/contacts

Create a contact. Call lookup-ares first when you have an IČO, to fill in the official name, address, and DIČ

MCP tool: create-contact

Request body

kind"company" | "person"
roles"customer" | "supplier" | "both"
namestringrequiredmax 160 chars
nameOnDocumentsstring | null
icostring | null
Czech company number (IČO), 8 digits.
dicstring | null
VAT number (DIČ), for example CZ12345678.
vatPayerType"payer" | "non_payer"
emailstring | null
phonestring | null
mobilestring | null
wwwstring | null
notestring | null
dataBoxIdstring | null
ID of the data box.
externalCodestring | null
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethod"transfer" | "cash" | "proforma" | "card" | "cod" | null
invoiceLanguage"cs" | "en" | "sk" | "de" | "fr" | "pl" | null
defaultCurrencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
creditWarnHalerinteger | null
Integer amount in haléře: 100 = 1 Kč.
creditBlockHalerinteger | null
Integer amount in haléře: 100 = 1 Kč.
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
allowDuplicateIcoboolean

Response · 201

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringrequired
kindstring
rolesstring
namestring
nameOnDocumentsstring | null
iconull | string
dicnull | string
vatPayerTypestring
emailnull | string
phonenull | string
mobilenull | string
wwwnull | string
notenull | string
dataBoxIdstring | null
externalCodenull | string
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethodstring | null
invoiceLanguagenull | string
defaultCurrencystring
creditWarnHalerinteger | null
creditBlockHalerinteger | null
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
unreliableVatPayerboolean | null
vatCheckedAtstring | null
viesValidboolean | null
viesCheckedAtstring | null
insolvencyStatusnull | string
insolvencyCheckedAtnull | stringdate-time
insolvencyProceedingsobject[]
iconull | stringrequired
urlstringrequired
namestringrequired
statestringrequired
activebooleanrequired
senatestringrequired
endedOnanyrequired
Null in every recorded response.
startedOnstringrequireddate
fileNumberstringrequired
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"required
idstringrequired
namestringrequired
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
bankAccountsobject[]
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
duplicateIcoobject
existingIdstringrequired
namestringrequired
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | string
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringrequired
overdueboolean
fileIdnull | stringrequired
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
POST/v1/contacts
curl -X POST https://api.damedoklad.cz/v1/contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o."
}'

Get a contact with its addresses, bank accounts, persons, and groups

GET/v1/contacts/{id}

Get a contact with its addresses, bank accounts, persons, and groups

MCP tool: get-contact

Path parameters

idstringrequired

Response · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringrequired
kindstring
rolesstring
namestring
nameOnDocumentsstring | null
iconull | string
dicnull | string
vatPayerTypestring
emailnull | string
phonenull | string
mobilenull | string
wwwnull | string
notenull | string
dataBoxIdstring | null
externalCodenull | string
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethodstring | null
invoiceLanguagenull | string
defaultCurrencystring
creditWarnHalerinteger | null
creditBlockHalerinteger | null
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
unreliableVatPayerboolean | null
vatCheckedAtstring | null
viesValidboolean | null
viesCheckedAtstring | null
insolvencyStatusnull | string
insolvencyCheckedAtnull | stringdate-time
insolvencyProceedingsobject[]
iconull | stringrequired
urlstringrequired
namestringrequired
statestringrequired
activebooleanrequired
senatestringrequired
endedOnanyrequired
Null in every recorded response.
startedOnstringrequireddate
fileNumberstringrequired
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"required
idstringrequired
namestringrequired
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
bankAccountsobject[]
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
duplicateIcoobject
existingIdstringrequired
namestringrequired
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | string
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringrequired
overdueboolean
fileIdnull | stringrequired
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
GET/v1/contacts/{id}
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Update a contact. Documents already issued keep the details they were issued with

PATCH/v1/contacts/{id}

Update a contact. Documents already issued keep the details they were issued with

MCP tool: update-contact

Path parameters

idstringrequired

Request body

kind"company" | "person"
roles"customer" | "supplier" | "both"
namestringmax 160 chars
nameOnDocumentsstring | null
icostring | null
Czech company number (IČO), 8 digits.
dicstring | null
VAT number (DIČ), for example CZ12345678.
vatPayerType"payer" | "non_payer"
emailstring | null
phonestring | null
mobilestring | null
wwwstring | null
notestring | null
dataBoxIdstring | null
ID of the data box.
externalCodestring | null
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethod"transfer" | "cash" | "proforma" | "card" | "cod" | null
invoiceLanguage"cs" | "en" | "sk" | "de" | "fr" | "pl" | null
defaultCurrencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
creditWarnHalerinteger | null
Integer amount in haléře: 100 = 1 Kč.
creditBlockHalerinteger | null
Integer amount in haléře: 100 = 1 Kč.
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
allowDuplicateIcoboolean

Response · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringrequired
kindstring
rolesstring
namestring
nameOnDocumentsstring | null
iconull | string
dicnull | string
vatPayerTypestring
emailnull | string
phonenull | string
mobilenull | string
wwwnull | string
notenull | string
dataBoxIdstring | null
externalCodenull | string
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethodstring | null
invoiceLanguagenull | string
defaultCurrencystring
creditWarnHalerinteger | null
creditBlockHalerinteger | null
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
unreliableVatPayerboolean | null
vatCheckedAtstring | null
viesValidboolean | null
viesCheckedAtstring | null
insolvencyStatusnull | string
insolvencyCheckedAtnull | stringdate-time
insolvencyProceedingsobject[]
iconull | stringrequired
urlstringrequired
namestringrequired
statestringrequired
activebooleanrequired
senatestringrequired
endedOnanyrequired
Null in every recorded response.
startedOnstringrequireddate
fileNumberstringrequired
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"required
idstringrequired
namestringrequired
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
bankAccountsobject[]
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
duplicateIcoobject
existingIdstringrequired
namestringrequired
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | string
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringrequired
overdueboolean
fileIdnull | stringrequired
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
PATCH/v1/contacts/{id}
curl -X PATCH https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "company",
  "roles": "customer",
  "name": "Pekárna U Lípy s.r.o."
}'

Delete a contact that no document uses

DELETE/v1/contacts/{id}

Delete a contact that no document uses

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

MCP tool: delete-contact

Path parameters

idstringrequired

Response · 200

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

List the documents and events connected to a contact

GET/v1/contacts/{id}/activity

List the documents and events connected to a contact

MCP tool: list-contact-activity

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
typestringrequired
atstringrequireddate-time
contactIdnull | string
documentIdnull | string
numbernull | string
documentTypenull | string
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/contacts/{id}/activity
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/activity \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List a contact's addresses

GET/v1/contacts/{id}/addresses

List a contact's addresses

MCP tool: list-contact-addresses

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/contacts/{id}/addresses
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/addresses \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add an address to a contact

POST/v1/contacts/{id}/addresses

Add an address to a contact

MCP tool: create-contact-address

Path parameters

idstringrequired

Request body

type"registered" | "delivery"required
namestring | null
streetstring | null
citystring | null
postalCodestring | null
countrystringmax 2 chars
regionstring | null
emailstring | null
phonestring | null
isDefaultboolean

Response · 201

idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
POST/v1/contacts/{id}/addresses
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/addresses \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "registered"
}'

Update an address of a contact

PATCH/v1/contacts/{id}/addresses/{addressId}

Update an address of a contact

MCP tool: update-contact-address

Path parameters

idstringrequired
addressIdstringrequired
ID of the address.

Request body

type"registered" | "delivery"
namestring | null
streetstring | null
citystring | null
postalCodestring | null
countrystringmax 2 chars
regionstring | null
emailstring | null
phonestring | null
isDefaultboolean

Response · 200

idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
PATCH/v1/contacts/{id}/addresses/{addressId}
curl -X PATCH https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/addresses/cad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "registered",
  "name": "Pekárna U Lípy s.r.o.",
  "street": "string"
}'

Remove an address from a contact

DELETE/v1/contacts/{id}/addresses/{addressId}

Remove an address from a contact

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

MCP tool: delete-contact-address

Path parameters

idstringrequired
addressIdstringrequired
ID of the address.

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/contacts/{id}/addresses/{addressId}
curl -X DELETE https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/addresses/cad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

List a contact's bank accounts

GET/v1/contacts/{id}/bank-accounts

List a contact's bank accounts

MCP tool: list-contact-bank-accounts

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/contacts/{id}/bank-accounts
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/bank-accounts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add a bank account to a contact

POST/v1/contacts/{id}/bank-accounts

Add a bank account to a contact

MCP tool: create-contact-bank-account

Path parameters

idstringrequired

Request body

labelstring | null
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
bankCodestring | null
ibanstring | null
IBAN without spaces.
bicstring | null
bankNamestring | null
bankStreetstring | null
bankCitystring | null
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
isDefaultboolean
publishedFromRegistryboolean

Response · 201

idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
POST/v1/contacts/{id}/bank-accounts
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/bank-accounts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "string",
  "accountNumber": "string",
  "bankCode": "0100"
}'

Update a bank account of a contact

PATCH/v1/contacts/{id}/bank-accounts/{accountId}

Update a bank account of a contact

MCP tool: update-contact-bank-account

Path parameters

idstringrequired
accountIdstringrequired
ID of the account. Find it with list-accounts.

Request body

labelstring | null
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
bankCodestring | null
ibanstring | null
IBAN without spaces.
bicstring | null
bankNamestring | null
bankStreetstring | null
bankCitystring | null
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
isDefaultboolean
publishedFromRegistryboolean

Response · 200

idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
PATCH/v1/contacts/{id}/bank-accounts/{accountId}
curl -X PATCH https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/bank-accounts/acc_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "label": "string",
  "accountNumber": "string",
  "bankCode": "0100"
}'

Remove a bank account from a contact

DELETE/v1/contacts/{id}/bank-accounts/{accountId}

Remove a bank account from a contact

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

MCP tool: delete-contact-bank-account

Path parameters

idstringrequired
accountIdstringrequired
ID of the account. Find it with list-accounts.

Response · 200

idstringrequired
deletedbooleanrequired
DELETE/v1/contacts/{id}/bank-accounts/{accountId}
curl -X DELETE https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/bank-accounts/acc_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Get what the contact owes against its credit limits (Kredit info and Kredit max). An optional amount shows what a new document would do

GET/v1/contacts/{id}/credit

Get what the contact owes against its credit limits (Kredit info and Kredit max). An optional amount shows what a new document would do

MCP tool: get-contact-credit

Path parameters

idstringrequired

Query parameters

documentHalerintegermin 0max 9007199254740991
Amount in CZK of a document about to be issued.

Response · 200

contactIdnull | stringrequired
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerinteger | nullrequired
availableHalerinteger | nullrequired
GET/v1/contacts/{id}/credit
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/credit \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Put a contact in a contact group

POST/v1/contacts/{id}/groups

Put a contact in a contact group

MCP tool: assign-contact-group

Path parameters

idstringrequired

Request body

groupIdstringrequired
ID of the group.

Response · 201

idstringrequired
namestringrequired
POST/v1/contacts/{id}/groups
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/groups \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

Take a contact out of a contact group

DELETE/v1/contacts/{id}/groups/{groupId}

Take a contact out of a contact group

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

MCP tool: unassign-contact-group

Path parameters

idstringrequired
groupIdstringrequired
ID of the group.

Response · 200

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

Check the contact by IČO in the Czech insolvency register (ISIR). If the register is down the answer is status unknown, not an error

POST/v1/contacts/{id}/insolvency-check

Check the contact by IČO in the Czech insolvency register (ISIR). If the register is down the answer is status unknown, not an error. Status found means a proceeding is running; clear means none is, though finished ones may be listed. Only a contact with an IČO can be checked: the register needs a birth number or date of birth to find a person.

MCP tool: check-contact-insolvency

Path parameters

idstringrequired

Response · 200

iconull | stringrequired
sourcestringrequired
statusstringrequired
proceedingsobject[]required
fileNumberstringrequired
senatestringrequired
namenull | stringrequired
iconull | stringrequired
statestringrequired
activebooleanrequired
startedOnstringrequireddate
endedOnanyrequired
Null in every recorded response.
urlstringrequired
syncedAtanyrequired
Null in every recorded response.
stalebooleanrequired
contactIdnull | stringrequired
POST/v1/contacts/{id}/insolvency-check
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/insolvency-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Have the insolvency register re-read for this contact every day. A change shows in the notifications and as the contact.insolvency_changed webhook

POST/v1/contacts/{id}/insolvency-watch

Have the insolvency register re-read for this contact every day. A change shows in the notifications and as the contact.insolvency_changed webhook. Needs an IČO. A register that is down changes nothing, and the next run asks again.

MCP tool: set-contact-insolvency-watch

Path parameters

idstringrequired

Request body

watchbooleanrequired

Response · 200

contactIdnull | stringrequired
watchbooleanrequired
POST/v1/contacts/{id}/insolvency-watch
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/insolvency-watch \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "watch": false
}'

Merge this contact into another one. Its documents move to the other contact and this one disappears

POST/v1/contacts/{id}/merge

Merge this contact into another one. Its documents move to the other contact and this one disappears

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

MCP tool: merge-contact

Path parameters

idstringrequired

Request body

intoIdstringrequired
ID of the into.

Response · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringrequired
kindstring
rolesstring
namestring
nameOnDocumentsstring | null
iconull | string
dicnull | string
vatPayerTypestring
emailnull | string
phonenull | string
mobilenull | string
wwwnull | string
notenull | string
dataBoxIdstring | null
externalCodenull | string
usualDueDaysinteger | null
supplierDueDaysinteger | null
preferredPaymentMethodstring | null
invoiceLanguagenull | string
defaultCurrencystring
creditWarnHalerinteger | null
creditBlockHalerinteger | null
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
unreliableVatPayerboolean | null
vatCheckedAtstring | null
viesValidboolean | null
viesCheckedAtstring | null
insolvencyStatusnull | string
insolvencyCheckedAtnull | stringdate-time
insolvencyProceedingsobject[]
iconull | stringrequired
urlstringrequired
namestringrequired
statestringrequired
activebooleanrequired
senatestringrequired
endedOnanyrequired
Null in every recorded response.
startedOnstringrequireddate
fileNumberstringrequired
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"required
idstringrequired
namestringrequired
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"required
idstringrequired
contactIdnull | stringrequired
typestringrequired
namestring | nullrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
regionnull | stringrequired
emailstring | nullrequired
phonestring | nullrequired
isDefaultbooleanrequired
bankAccountsobject[]
object"bank_account"required
idstringrequired
contactIdnull | string
labelnull | string
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibannull | stringrequired
currencystringrequired
isDefaultbooleanrequired
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanrequired
enabledbooleanrequired
lastSyncedAtnull | stringrequireddate-time
lastSyncedOnnull | stringrequireddate
lastErrornull | stringrequired
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
duplicateIcoobject
existingIdstringrequired
namestringrequired
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | string
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatenull | stringrequireddate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringrequired
overdueboolean
fileIdnull | stringrequired
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
POST/v1/contacts/{id}/merge
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/merge \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "intoId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

List a contact's people

GET/v1/contacts/{id}/persons

List a contact's people

MCP tool: list-contact-persons

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"contact_person"required
idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/contacts/{id}/persons
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/persons \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Add a person to a contact

POST/v1/contacts/{id}/persons

Add a person to a contact

MCP tool: create-contact-person

Path parameters

idstringrequired

Request body

namestringrequiredmax 160 chars
greetingstring | null
titlestring | null
emailstring | null
phonestring | null
mobilestring | null
notestring | null

Response · 201

idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
POST/v1/contacts/{id}/persons
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/persons \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o."
}'

Update a person of a contact

PATCH/v1/contacts/{id}/persons/{personId}

Update a person of a contact

MCP tool: update-contact-person

Path parameters

idstringrequired
personIdstringrequired
ID of the person.

Request body

namestringmax 160 chars
greetingstring | null
titlestring | null
emailstring | null
phonestring | null
mobilestring | null
notestring | null

Response · 200

idstringrequired
contactIdstringrequired
namestringrequired
greetingstring | nullrequired
titlenull | stringrequired
emailnull | stringrequired
phonenull | stringrequired
mobilestring | nullrequired
notestring | nullrequired
PATCH/v1/contacts/{id}/persons/{personId}
curl -X PATCH https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/persons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "greeting": "string",
  "title": "string"
}'

Remove a person from a contact

DELETE/v1/contacts/{id}/persons/{personId}

Remove a person from a contact

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

MCP tool: delete-contact-person

Path parameters

idstringrequired
personIdstringrequired
ID of the person.

Response · 200

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

Check the contact in the Czech VAT register: whether it is a reliable payer and which bank accounts it has published

POST/v1/contacts/{id}/vat-check

Check the contact in the Czech VAT register: whether it is a reliable payer and which bank accounts it has published

MCP tool: vat-check-contact

Path parameters

idstringrequired

Request body

applyAccountsboolean

Response · 200

sourcestringrequired
checkedAtnull | stringrequireddate-time
dicnull | stringrequired
unreliablebooleanrequired
publishedAccountsobject[]required
accountNumbernull | stringrequired
bankCodenull | stringrequired
ibanstring | nullrequired
appliedAccountsany[]required
POST/v1/contacts/{id}/vat-check
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/vat-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "applyAccounts": false
}'

Check the contact's EU VAT number in the VIES register

POST/v1/contacts/{id}/vies

Check the contact's EU VAT number in the VIES register

MCP tool: vies-check-contact

Path parameters

idstringrequired

Response · 200

sourcestringrequired
checkedAtnull | stringdate-time
vatNumberstringrequired
validbooleanrequired
namenull | string
addressnull | string
wellFormedboolean
POST/v1/contacts/{id}/vies
curl -X POST https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/vies \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Download all contacts as an XLSX spreadsheet

GET/v1/contacts/export

Download all contacts as an XLSX spreadsheet

MCP tool: export-contacts

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.
qstringmax 200 chars
Older name for `search`.
rolesstring
customer, supplier, or both.
owing"true" | "false"
`true`: only contacts that owe you money.
restricted"true" | "false"
`true`: only contacts whose processing is restricted under GDPR. They are left out otherwise.
groupIdstring
Only contacts in this contact group.
customFieldKeystring
Only records with this custom field. Alone: it has any value. With customFieldValue: exactly that value, ignoring case.
customFieldValuestringmax 2000 chars

Response · 200

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

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

Import contacts from an uploaded spreadsheet file

POST/v1/contacts/import

Import contacts from an uploaded spreadsheet file

MCP tool: import-contacts

Request body

fileBase64string
File content encoded as base64.
rowsobject[]

Response · 200

countintegerrequired
idsstring[]required
POST/v1/contacts/import
curl -X POST https://api.damedoklad.cz/v1/contacts/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string",
  "rows": [
    {}
  ]
}'

Turn the daily insolvency re-check on or off for many contacts at once. A contact without an IČO is reported and left as it was

POST/v1/contacts/insolvency-watch

Turn the daily insolvency re-check on or off for many contacts at once. A contact without an IČO is reported and left as it was

MCP tool: set-contacts-insolvency-watch

Request body

idsstring[]required
watchbooleanrequired

Response · 200

resultsobject[]required
idstring
okbooleanrequired
errornull | string
codenull | string
numbernull | string
stockDocumentIdnull | string
documentIdnull | string
statusstring
contactNamenull | string
namenull | string
tostring
amountHalerinteger | null
movementIdnull | string
rowinteger
recognisedboolean
shipmentIdstring
trackingNumbernull | string
totalintegerrequired
succeededintegerrequired
failedintegerrequired
POST/v1/contacts/insolvency-watch
curl -X POST https://api.damedoklad.cz/v1/contacts/insolvency-watch \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "watch": false
}'

Look up a company in the Czech ARES business register by IČO. Changes nothing

POST/v1/contacts/lookup/ares

Look up a company in the Czech ARES business register by IČO. Changes nothing

MCP tool: lookup-ares

Request body

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

Response · 200

sourcestringrequired
iconull | stringrequired
dicnull | stringrequired
namenull | stringrequired
vatPayerTypestringrequired
addressnull | objectrequired
streetnull | stringrequired
citynull | stringrequired
postalCodenull | stringrequired
countrynull | stringrequired
POST/v1/contacts/lookup/ares
curl -X POST https://api.damedoklad.cz/v1/contacts/lookup/ares \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ico": "12345678"
}'