Přejít na obsah

Kontakty

Operace ve skupině Kontakty.

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

Seznam: skupiny, kontakt

GET/v1/contact-groups

List contact groups

Nástroj MCP: list-contact-groups

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"contact_group"povinné
idstringpovinné
namestringpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: skupina, kontakt

POST/v1/contact-groups

Create a contact group

Nástroj MCP: create-contact-group

Tělo požadavku

namestringpovinnémax 80 chars

Odpověď · 201

idstringpovinné
namestringpovinné
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."
}'

Seznam: kontakty

GET/v1/contacts

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

Nástroj MCP: list-contacts

Parametry dotazu

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

Odpověď · 200

dataobject[]povinné
customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
object"contact"povinné
idstringpovinné
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 | stringpovinné
urlstringpovinné
namestringpovinné
statestringpovinné
activebooleanpovinné
senatestringpovinné
endedOnanypovinné
Null in every recorded response.
startedOnstringpovinnédate
fileNumberstringpovinné
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"povinné
idstringpovinné
namestringpovinné
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
bankAccountsobject[]
object"bank_account"povinné
idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
duplicateIcoobject
existingIdstringpovinné
namestringpovinné
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | string
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatenull | stringpovinnédate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringpovinné
overdueboolean
fileIdnull | stringpovinné
supplierDocumentNumbernull | string
kindstring
originalInvoiceNumbernull | string
deliveryDatestringdate
carrierIdstring | null
mergedFromstring
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: kontakt

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Č

Nástroj MCP: create-contact

Tělo požadavku

kind"company" | "person"
roles"customer" | "supplier" | "both"
namestringpovinnémax 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

Odpověď · 201

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringpovinné
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 | stringpovinné
urlstringpovinné
namestringpovinné
statestringpovinné
activebooleanpovinné
senatestringpovinné
endedOnanypovinné
Null in every recorded response.
startedOnstringpovinnédate
fileNumberstringpovinné
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"povinné
idstringpovinné
namestringpovinné
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
bankAccountsobject[]
object"bank_account"povinné
idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
duplicateIcoobject
existingIdstringpovinné
namestringpovinné
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | string
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatenull | stringpovinnédate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringpovinné
overdueboolean
fileIdnull | stringpovinné
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."
}'

Detail: kontakt

GET/v1/contacts/{id}

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

Nástroj MCP: get-contact

Parametry v cestě

idstringpovinné

Odpověď · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringpovinné
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 | stringpovinné
urlstringpovinné
namestringpovinné
statestringpovinné
activebooleanpovinné
senatestringpovinné
endedOnanypovinné
Null in every recorded response.
startedOnstringpovinnédate
fileNumberstringpovinné
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"povinné
idstringpovinné
namestringpovinné
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
bankAccountsobject[]
object"bank_account"povinné
idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
duplicateIcoobject
existingIdstringpovinné
namestringpovinné
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | string
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatenull | stringpovinnédate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringpovinné
overdueboolean
fileIdnull | stringpovinné
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"

Úprava: kontakt

PATCH/v1/contacts/{id}

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

Nástroj MCP: update-contact

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringpovinné
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 | stringpovinné
urlstringpovinné
namestringpovinné
statestringpovinné
activebooleanpovinné
senatestringpovinné
endedOnanypovinné
Null in every recorded response.
startedOnstringpovinnédate
fileNumberstringpovinné
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"povinné
idstringpovinné
namestringpovinné
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
bankAccountsobject[]
object"bank_account"povinné
idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
duplicateIcoobject
existingIdstringpovinné
namestringpovinné
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | string
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatenull | stringpovinnédate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringpovinné
overdueboolean
fileIdnull | stringpovinné
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."
}'

Smazání: kontakt

DELETE/v1/contacts/{id}

Delete a contact that no document uses

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

Nástroj MCP: delete-contact

Parametry v cestě

idstringpovinné

Odpověď · 200

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

Seznam: aktivita, kontakt

GET/v1/contacts/{id}/activity

List the documents and events connected to a contact

Nástroj MCP: list-contact-activity

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
typestringpovinné
atstringpovinnédate-time
contactIdnull | string
documentIdnull | string
numbernull | string
documentTypenull | string
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Seznam: adresy, kontakt

GET/v1/contacts/{id}/addresses

List a contact's addresses

Nástroj MCP: list-contact-addresses

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: adresa, kontakt

POST/v1/contacts/{id}/addresses

Add an address to a contact

Nástroj MCP: create-contact-address

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 201

idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
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"
}'

Úprava: adresa, kontakt

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

Update an address of a contact

Nástroj MCP: update-contact-address

Parametry v cestě

idstringpovinné
addressIdstringpovinné
ID of the address.

Tělo požadavku

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

Odpověď · 200

idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
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"
}'

Smazání: adresa, kontakt

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

Remove an address from a contact

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

Nástroj MCP: delete-contact-address

Parametry v cestě

idstringpovinné
addressIdstringpovinné
ID of the address.

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
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"

Seznam: bankovní účty, kontakt

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

List a contact's bank accounts

Nástroj MCP: list-contact-bank-accounts

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

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

Vytvoření: bankovní účet, kontakt

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

Add a bank account to a contact

Nástroj MCP: create-contact-bank-account

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 201

idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
POST/v1/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"
}'

Úprava: bankovní účet, kontakt

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

Update a bank account of a contact

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

Parametry v cestě

idstringpovinné
accountIdstringpovinné
ID of the account. Find it with list-accounts.

Tělo požadavku

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

Odpověď · 200

idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
PATCH/v1/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"
}'

Smazání: bankovní účet, kontakt

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

Remove a bank account from a contact

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

Nástroj MCP: delete-contact-bank-account

Parametry v cestě

idstringpovinné
accountIdstringpovinné
ID of the account. Find it with list-accounts.

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
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

Nástroj MCP: get-contact-credit

Parametry v cestě

idstringpovinné

Parametry dotazu

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

Odpověď · 200

contactIdnull | stringpovinné
levelstringpovinné
exposureHalerintegerpovinné
afterHalerintegerpovinné
warnHalerinteger | nullpovinné
blockHalerinteger | nullpovinné
availableHalerinteger | nullpovinné
GET/v1/contacts/{id}/credit
curl https://api.damedoklad.cz/v1/contacts/con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/credit \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Přiřazení: skupina, kontakt

POST/v1/contacts/{id}/groups

Put a contact in a contact group

Nástroj MCP: assign-contact-group

Parametry v cestě

idstringpovinné

Tělo požadavku

groupIdstringpovinné
ID of the group.

Odpověď · 201

idstringpovinné
namestringpovinné
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"
}'

Odebrání: skupina, kontakt

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

Take a contact out of a contact group

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

Nástroj MCP: unassign-contact-group

Parametry v cestě

idstringpovinné
groupIdstringpovinné
ID of the group.

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
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.

Nástroj MCP: check-contact-insolvency

Parametry v cestě

idstringpovinné

Odpověď · 200

iconull | stringpovinné
sourcestringpovinné
statusstringpovinné
proceedingsobject[]povinné
fileNumberstringpovinné
senatestringpovinné
namenull | stringpovinné
iconull | stringpovinné
statestringpovinné
activebooleanpovinné
startedOnstringpovinnédate
endedOnanypovinné
Null in every recorded response.
urlstringpovinné
syncedAtanypovinné
Null in every recorded response.
stalebooleanpovinné
contactIdnull | stringpovinné
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.

Nástroj MCP: set-contact-insolvency-watch

Parametry v cestě

idstringpovinné

Tělo požadavku

watchbooleanpovinné

Odpověď · 200

contactIdnull | stringpovinné
watchbooleanpovinné
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
}'

Sloučení: kontakt

POST/v1/contacts/{id}/merge

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

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

Nástroj MCP: merge-contact

Parametry v cestě

idstringpovinné

Tělo požadavku

intoIdstringpovinné
ID of the into.

Odpověď · 200

customFieldsobject
oborstring
oblaststring
regionnull | string
slevainteger
smlouva_odstringdate
poznamka_obchodustring
idstringpovinné
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 | stringpovinné
urlstringpovinné
namestringpovinné
statestringpovinné
activebooleanpovinné
senatestringpovinné
endedOnanypovinné
Null in every recorded response.
startedOnstringpovinnédate
fileNumberstringpovinné
gdprRestrictedboolean
marketingOptOutboolean
owingHalerinteger
groupIdsstring[]
groupsobject[]
object"contact_group"povinné
idstringpovinné
namestringpovinné
createdAtnull | stringdate-time
updatedAtnull | stringdate-time
insolvencyWatchboolean
insolvencyChangedAtnull | stringdate-time
addressesobject[]
object"address"povinné
idstringpovinné
contactIdnull | stringpovinné
typestringpovinné
namestring | nullpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
regionnull | stringpovinné
emailstring | nullpovinné
phonestring | nullpovinné
isDefaultbooleanpovinné
bankAccountsobject[]
object"bank_account"povinné
idstringpovinné
contactIdnull | string
labelnull | string
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibannull | stringpovinné
currencystringpovinné
isDefaultbooleanpovinné
publishedFromRegistryboolean
bicnull | string
bankNamenull | string
bankStreetstring | null
bankCitystring | null
namestring
swiftnull | string
ledgerAccountstring
isActiveboolean
openingBalanceHalerinteger
openingDatenull | stringdate
openingExchangeRatestring | null
openingStatestring
bankBalanceHalerinteger | null
bankBalanceOnnull | stringdate
fioobject
configuredbooleanpovinné
enabledbooleanpovinné
lastSyncedAtnull | stringpovinnédate-time
lastSyncedOnnull | stringpovinnédate
lastErrornull | stringpovinné
createdAtstringdate-time
balanceHalerinteger
unmatchedCountinteger
balanceDiffHalerinteger | null
sepaCreditorIdnull | string
personsobject[]
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
duplicateIcoobject
existingIdstringpovinné
namestringpovinné
attachmentsany[]
documentsobject[]
object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | string
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatenull | stringpovinnédate
dueDatenull | stringdate
currencynull | string
totalHalerinteger | null
paidHalerinteger
statusstringpovinné
overdueboolean
fileIdnull | stringpovinné
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"
}'

Seznam: osoby, kontakt

GET/v1/contacts/{id}/persons

List a contact's people

Nástroj MCP: list-contact-persons

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"contact_person"povinné
idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: osoba, kontakt

POST/v1/contacts/{id}/persons

Add a person to a contact

Nástroj MCP: create-contact-person

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringpovinnémax 160 chars
greetingstring | null
titlestring | null
emailstring | null
phonestring | null
mobilestring | null
notestring | null

Odpověď · 201

idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
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."
}'

Úprava: osoba, kontakt

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

Update a person of a contact

Nástroj MCP: update-contact-person

Parametry v cestě

idstringpovinné
personIdstringpovinné
ID of the person.

Tělo požadavku

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

Odpověď · 200

idstringpovinné
contactIdstringpovinné
namestringpovinné
greetingstring | nullpovinné
titlenull | stringpovinné
emailnull | stringpovinné
phonenull | stringpovinné
mobilestring | nullpovinné
notestring | nullpovinné
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"
}'

Smazání: osoba, kontakt

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

Remove a person from a contact

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

Nástroj MCP: delete-contact-person

Parametry v cestě

idstringpovinné
personIdstringpovinné
ID of the person.

Odpověď · 200

idstringpovinné
deletedbooleanpovinné
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"

Kontrola plátce DPH

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

Nástroj MCP: vat-check-contact

Parametry v cestě

idstringpovinné

Tělo požadavku

applyAccountsboolean

Odpověď · 200

sourcestringpovinné
checkedAtnull | stringpovinnédate-time
dicnull | stringpovinné
unreliablebooleanpovinné
publishedAccountsobject[]povinné
accountNumbernull | stringpovinné
bankCodenull | stringpovinné
ibanstring | nullpovinné
appliedAccountsany[]povinné
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
}'

Kontrola DIČ ve VIES

POST/v1/contacts/{id}/vies

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

Nástroj MCP: vies-check-contact

Parametry v cestě

idstringpovinné

Odpověď · 200

sourcestringpovinné
checkedAtnull | stringdate-time
vatNumberstringpovinné
validbooleanpovinné
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"

Export: kontakt

GET/v1/contacts/export

Download all contacts as an XLSX spreadsheet

Nástroj MCP: export-contacts

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
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

Odpověď · 200

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

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

Import: kontakt

POST/v1/contacts/import

Import contacts from an uploaded spreadsheet file

Nástroj MCP: import-contacts

Tělo požadavku

fileBase64string
File content encoded as base64.
rowsobject[]

Odpověď · 200

countintegerpovinné
idsstring[]povinné
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

Nástroj MCP: set-contacts-insolvency-watch

Tělo požadavku

idsstring[]povinné
watchbooleanpovinné

Odpověď · 200

resultsobject[]povinné
idstring
okbooleanpovinné
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
totalintegerpovinné
succeededintegerpovinné
failedintegerpovinné
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
}'

Vyhledání v ARES

POST/v1/contacts/lookup/ares

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

Nástroj MCP: lookup-ares

Tělo požadavku

icostringpovinnémax 16 chars
Czech company number (IČO), 8 digits.

Odpověď · 200

sourcestringpovinné
iconull | stringpovinné
dicnull | stringpovinné
namenull | stringpovinné
vatPayerTypestringpovinné
addressnull | objectpovinné
streetnull | stringpovinné
citynull | stringpovinné
postalCodenull | stringpovinné
countrynull | stringpovinné
POST/v1/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"
}'