# DPH a daně · API DameDokladu

> Operace ve skupině DPH a daně.

Source: https://damedoklad.cz/docs/api-reference/tax/

# DPH a daně

Operace ve skupině DPH a daně.

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

GET `/v1/tax/bad-debts`

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

Nástroj MCP: `list-tax-bad-debts`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

`from` string YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`data` any\[\] povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/bad-debts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/bad-debts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/bad-debts`

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

Nástroj MCP: `create-tax-bad-debt`

### Tělo požadavku

`side` "creditor" | "debtor"

`kind` "reduction" | "increase"

`documentType` "invoice" | "received\_invoice" povinné

`documentId` string povinné

ID of the document.

`correctionDate` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`unpaidHaler` integer povinné min -9007199254740991 max 9007199254740991

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

`vatRate` integer povinné min 0 max 100

`ground` "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "74b1" | "74b2" | "74b3" | "74b4"

`facts` object

`firstOrderOn` string YYYY-MM-DD

Date as YYYY-MM-DD.

`limitSuspended` boolean

`legalGround` string max 200 chars

`evidenceNumber` string max 60 chars

`note` string max 2000 chars

### Odpověď · 201

`id` string povinné

`side` string povinné

`documentType` string povinné

`documentId` string povinné

`kind` string povinné

`ground` null | string povinné

`facts` object povinné

`notRelated` boolean

`debtorKnown` boolean

`didNotKnowUnpaid` boolean

`enforcementStoppedNoAssets` boolean

`noOtherGround` boolean

`twoWrittenNotices` boolean

`insolvencyDecision` boolean

`insolvencyClaimFiled` boolean

`firstOrderOn` string | null povinné

`limitSuspended` boolean povinné

`correctionDate` string povinné date

`unpaidHaler` integer povinné

`vatRate` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`legalGround` null | string povinné

`evidenceNumber` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/bad-debts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "correctionDate": "2026-10-30",
  "unpaidHaler": 1210000,
  "vatRate": 21
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "correctionDate": "2026-10-30",
    "unpaidHaler": 1210000,
    "vatRate": 21
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/bad-debts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "correctionDate": "2026-10-30",
        "unpaidHaler": 1210000,
        "vatRate": 21
    },
)
data = response.json()
```

## Delete a bad debt correction

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

Delete a bad debt correction

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

Nástroj MCP: `delete-tax-bad-debt`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/bad-debts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/bad-debts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/bad-debts/check`

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

Nástroj MCP: `check-tax-bad-debt`

### Tělo požadavku

`side` "creditor" | "debtor"

`kind` "reduction" | "increase"

`documentType` "invoice" | "received\_invoice" povinné

`documentId` string povinné

ID of the document.

`correctionDate` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`unpaidHaler` integer povinné min -9007199254740991 max 9007199254740991

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

`vatRate` integer povinné min 0 max 100

`ground` "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "74b1" | "74b2" | "74b3" | "74b4"

`facts` object

`firstOrderOn` string YYYY-MM-DD

Date as YYYY-MM-DD.

`limitSuspended` boolean

`legalGround` string max 200 chars

`evidenceNumber` string max 60 chars

`note` string max 2000 chars

### Odpověď · 200

`allowed` boolean povinné

`conditions` object\[\] povinné

`code` null | string povinné

`met` boolean povinné

`section` string povinné

`message` null | string povinné

`latestDate` null | string povinné date

`side` string povinné

`section` string povinné

`deadline` string date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/bad-debts/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "correctionDate": "2026-10-30",
  "unpaidHaler": 1210000,
  "vatRate": 21
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts/check', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "correctionDate": "2026-10-30",
    "unpaidHaler": 1210000,
    "vatRate": 21
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/bad-debts/check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "correctionDate": "2026-10-30",
        "unpaidHaler": 1210000,
        "vatRate": 21
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `list-tax-debtor-corrections`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_debtor\_correction" povinné

`id` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`action` string povinné

`dueDate` null | string povinné date

`deadline` string povinné date

`lastPayDay` string povinné date

`unpaidHaler` integer povinné

`alreadyCorrectedHaler` integer povinné

`vatRate` integer povinné

`rates` object\[\] povinné

`vatRate` integer povinné

`unpaidHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`correctionDate` string povinné date

`currency` null | string povinné

`lastDate` string date

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/bad-debts/debtor-due \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts/debtor-due', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/bad-debts/debtor-due",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/bad-debts/grounds`

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

Nástroj MCP: `get-tax-bad-debt-grounds`

### Odpověď · 200

`common` string\[\] povinné

`grounds` object\[\] povinné

`ground` null | string povinné

`section` string povinné

`facts` string\[\] povinné

`date` string

`factLabels` object povinné

`enforcementRunning` string povinné

`enforcementStoppedNoAssets` string povinné

`insolvencyClaimFiled` string povinné

`insolvencyDecision` string povinné

`probateFinished` string povinné

`proceedingRunning` string povinné

`rightsExercised` string povinné

`otherClaimEnforcementEnded` string povinné

`otherClaimEnforcementRunning` string povinné

`twoWrittenNotices` string povinné

`noOtherGround` string povinné

`debtorKnown` string povinné

`didNotKnowUnpaid` string povinné

`notRelated` string povinné

```bash
curl https://api.damedoklad.cz/v1/tax/bad-debts/grounds \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/bad-debts/grounds', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/bad-debts/grounds",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/calendar`

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

Nástroj MCP: `get-tax-calendar`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`year` integer povinné

`data` object\[\] povinné

`form` string povinné

`periodKey` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`status` string povinné

`daysLeft` integer povinné

`overdue` boolean povinné

`key` string povinné

`kind` string povinné

`amountKc` integer | null povinné

`total` integer povinné

`hasMore` boolean povinné

```bash
curl https://api.damedoklad.cz/v1/tax/calendar \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/calendar', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/calendar",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/deadlines`

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

Nástroj MCP: `list-tax-deadlines`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`form` string povinné

`periodKey` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`status` string povinné

`daysLeft` integer povinné

`overdue` boolean povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/deadlines \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/deadlines', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/deadlines",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/eu-registrations`

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

Nástroj MCP: `list-eu-vat-registrations`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "eu\_vat\_registration" povinné

`id` string povinné

`country` null | string povinné

`vatNumber` string povinné

`validFrom` null | string povinné date

`validTo` null | string povinné date

`establishment` null | string povinné

`basicRate` integer | null povinné

`reducedRate` integer | null povinné

`secondReducedRate` integer | null povinné

`currency` null | string povinné

`vatAccount` string povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/eu-registrations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/eu-registrations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/eu-registrations`

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

Nástroj MCP: `create-eu-vat-registration`

### Tělo požadavku

`country` string povinné 2 chars

`vatNumber` string povinné min 3 chars max 20 chars

`validFrom` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`validTo` string | null

Date as YYYY-MM-DD.

`establishment` string | null

`basicRate` number | null

`reducedRate` number | null

`secondReducedRate` number | null

`currency` string | null

ISO 4217 currency code, for example CZK or EUR.

### Odpověď · 201

`id` string povinné

`country` null | string povinné

`vatNumber` string povinné

`validFrom` null | string povinné date

`validTo` null | string povinné date

`establishment` null | string povinné

`basicRate` integer | null povinné

`reducedRate` integer | null povinné

`secondReducedRate` integer | null povinné

`currency` null | string povinné

`vatAccount` string povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/eu-registrations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "string",
  "vatNumber": "string",
  "validFrom": "2026-10-30"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/eu-registrations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "country": "string",
        "vatNumber": "string",
        "validFrom": "2026-10-30"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `update-eu-vat-registration`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`country` string 2 chars

`vatNumber` string min 3 chars max 20 chars

`validFrom` string YYYY-MM-DD

Date as YYYY-MM-DD.

`validTo` string | null

Date as YYYY-MM-DD.

`establishment` string | null

`basicRate` number | null

`reducedRate` number | null

`secondReducedRate` number | null

`currency` string | null

ISO 4217 currency code, for example CZK or EUR.

### Odpověď · 200

`id` string povinné

`country` null | string povinné

`vatNumber` string povinné

`validFrom` null | string povinné date

`validTo` null | string povinné date

`establishment` null | string povinné

`basicRate` integer | null povinné

`reducedRate` integer | null povinné

`secondReducedRate` integer | null povinné

`currency` null | string povinné

`vatAccount` string povinné

```bash
curl -X PATCH https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "string",
  "vatNumber": "string",
  "validFrom": "2026-10-30"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "country": "string",
    "vatNumber": "string",
    "validFrom": "2026-10-30"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "country": "string",
        "vatNumber": "string",
        "validFrom": "2026-10-30"
    },
)
data = response.json()
```

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

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

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

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

Nástroj MCP: `delete-eu-vat-registration`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`country` null | string povinné

`vatNumber` string povinné

`validFrom` null | string povinné date

`validTo` null | string povinné date

`establishment` null | string povinné

`basicRate` integer | null povinné

`reducedRate` integer | null povinné

`secondReducedRate` integer | null povinné

`currency` null | string povinné

`vatAccount` string povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/eu-registrations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-eu-registration-for-contact`

### Parametry dotazu

`contactId` string povinné

ID of the contact. Find it with list-contacts.

`date` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`country` null | string povinné

`registered` boolean povinné

`currency` null | string povinné

```bash
curl https://api.damedoklad.cz/v1/tax/eu-registrations/for-contact \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations/for-contact', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/eu-registrations/for-contact",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/eu-registrations/rates`

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

Nástroj MCP: `get-eu-vat-rates`

### Parametry dotazu

`country` string povinné 2 chars

`date` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`country` null | string povinné

`date` string povinné date

`currency` null | string povinné

`known` boolean povinné

`standard` integer povinné

`reduced` integer\[\] povinné

```bash
curl https://api.damedoklad.cz/v1/tax/eu-registrations/rates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations/rates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/eu-registrations/rates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/eu-registrations/summary`

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

Nástroj MCP: `get-eu-vat-summary`

### Parametry dotazu

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`from` string povinné date

`to` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`currency` null | string povinné

`rate` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`documentCount` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/eu-registrations/summary \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/eu-registrations/summary', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/eu-registrations/summary",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## List tax filings, newest first, with their status

GET `/v1/tax/filings`

List tax filings, newest first, with their status

Nástroj MCP: `list-tax-filings`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

`from` string YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string YYYY-MM-DD

Date as YYYY-MM-DD.

`form` "DPHDP3" | "DPHKH1" | "DPHSHV" | "DPFDP7" | "DPPDP9" | "DSLDP3" | "OSSEI1" | "OSSNI1" | "OSSII1" | "SMEHL1" | "SMEOZ1" | "DNEDP6" | "OSVCSS" | "OSVCZP"

`year` integer min -9007199254740991 max 9007199254740991

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_filing" povinné

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`certificates` object\[\]

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`A2` object\[\] povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`A5` object povinné

`B1` any\[\] povinné

`B2` object\[\] povinné

`B3` object povinné

`C` object povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`tableB` null | object

`tableC` object

`tableF` object

`tableG` integer

`tableH` null | object

`tableI` null | object

`tableJ` any

Null in every recorded response.

`tableK` object

`losses` object\[\] povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`inputs` object povinné

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`attachment2` null | object

`attachment3` null | object

`attachment4` null | object

`foreignCertificates` object\[\]

`spouse` object

`children` object\[\]

`employers` object\[\]

`bonus` object

`spouseDetails` object

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`liabilities` object\[\] povinné

`income` object\[\] povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`mainStart` object povinné

`side` object povinné

`health` object povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`mainStart` object povinné

`side` object povinné

`health` object povinné

`computed` object

`year` integer povinné

`land` object\[\]

`buildings` object\[\]

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`returnDue` string date

`rows` object\[\]

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`issues` object\[\] povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/filings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/filings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/filings`

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

Nástroj MCP: `create-tax-filing`

### Tělo požadavku

`form` "DPHDP3" | "DPHKH1" | "DPHSHV" | "DPFDP7" | "DPPDP9" | "DSLDP3" | "OSSEI1" | "OSSNI1" | "OSSII1" | "SMEHL1" | "SMEOZ1" | "DNEDP6" | "OSVCSS" | "OSVCZP" povinné

`year` integer povinné min 2016 max 2100

`month` integer min 1 max 12

`quarter` integer min 1 max 4

`kind` "regular" | "corrective" | "additional" | "additional\_corrective" | "followup" | "followup\_corrective"

`discoveredOn` string YYYY-MM-DD

Date as YYYY-MM-DD.

`nextPeriodCode` "Q" | "M"

`callNumber` string max 32 chars

`note` string max 2000 chars

`inputs` object

### Odpověď · 201

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/filings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "form": "DPHDP3",
  "year": 2026
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/filings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "form": "DPHDP3",
        "year": 2026
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-tax-filing`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PATCH `/v1/tax/filings/{id}`

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

Nástroj MCP: `update-tax-filing`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`discoveredOn` string | null

Date as YYYY-MM-DD.

`nextPeriodCode` "Q" | "M" | null

`callNumber` string | null

`note` string | null

`inputs` object

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X PATCH https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "discoveredOn": "2026-10-30",
  "nextPeriodCode": "Q",
  "callNumber": "string"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "discoveredOn": "2026-10-30",
    "nextPeriodCode": "Q",
    "callNumber": "string"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "discoveredOn": "2026-10-30",
        "nextPeriodCode": "Q",
        "callNumber": "string"
    },
)
data = response.json()
```

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

DELETE `/v1/tax/filings/{id}`

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

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

Nástroj MCP: `delete-tax-filing`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `mark-tax-filing-filed`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`filedOn` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`reference` string max 100 chars

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filed \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "filedOn": "2026-10-30"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/filed",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "filedOn": "2026-10-30"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `finalize-tax-filing`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/finalize \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/finalize', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/finalize",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `override-tax-filing-row`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`field` string povinné

`value` integer | null povinné

`reason` string povinné min 3 chars max 500 chars

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/overrides \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "field": "string",
  "value": -9007199254740991,
  "reason": "string"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/overrides', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "field": "string",
    "value": -9007199254740991,
    "reason": "string"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/overrides",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "field": "string",
        "value": -9007199254740991,
        "reason": "string"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `download-tax-filing-pdf`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

Vrací soubor application/pdf.

```bash
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content
```

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

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

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

Nástroj MCP: `reopen-tax-filing`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`reason` string povinné min 3 chars max 500 chars

### Odpověď · 200

`id` string povinné

`form` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`kind` string povinné

`status` string povinné

`discoveredOn` null | string povinné date

`nextPeriodCode` string | null povinné

`callNumber` string | null povinné

`overrides` object povinné

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`advancesPaidKc` integer

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`sub` string povinné

`letter` string povinné

`section` string povinné

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`eurRate` integer

`schemeNumber` string

`internalNumber` string

`additionalReasons` string

`osszCode` string

`birthDate` null | string date

`mainMonths` integer

`sideMonths` integer

`birthNumber` string

`overpaymentToAdvances` boolean

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRateDate` string date

`losses` object\[\]

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`usedNowKc` integer povinné

`usedPriorKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`states` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`taxCredits` object

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`turnoverKc` integer

`researchClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`educationClaims` object\[\]

`to` string povinné date

`from` string povinné date

`claimKc` integer povinné

`usedNowKc` integer povinné

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`cooperating` object\[\] povinné

`dic` null | string povinné

`lastName` null | string povinné

`relation` string povinné

`sharePct` integer povinné

`firstName` null | string povinné

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné

`separateBaseIncomes` object\[\]

`kind` string povinné

`country` null | string povinné

`incomeKc` integer povinné

`description` null | string povinné

`foreignTaxKc` integer

`acquisitionCostKc` integer

`otherDeductionsKc` integer

`taxReturnDuty` boolean

`variableSymbol` null | string

`nextSide` boolean

`flatTaxReason` string

`sideReason_zam` boolean

`cooperatingCity` string

`cooperatingLastName` string

`filedElectronically` boolean

`cooperatingBirthDate` string date

`cooperatingFirstName` string

`cooperatingPostalCode` string

`cooperatingBirthNumber` string

`cooperatingHouseNumber` string

`foreign` object

`credits` object\[\] povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`certificates` object\[\]

`taxKc` integer povinné

`country` null | string povinné

`incomeKc` integer povinné

`taxLocal` integer povinné

`authority` string povinné

`publication` object

`email` null | string povinné

`notes` boolean

`equityChanges` boolean

`statementFiles` string\[\]

`rental` object

`flat` boolean povinné

`incomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`firstName` null | string povinné

`childUnder3` boolean povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`otherIncome` object\[\]

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`description` null | string povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`bonusEligible` boolean

`previousId` null | string povinné

`finalizedAt` null | string povinné date-time

`filedOn` null | string povinné date

`filedReference` null | string povinné

`note` string | null povinné

`createdAt` string povinné date-time

`updatedAt` string povinné date-time

`computed` object

`form` string povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`subject` null | object povinné

`oid` string

`workspaceOid` string

`subjectType` string povinné

`firstName` null | string

`lastName` null | string

`title` string | null

`financeOfficeCode` null | string

`workplaceCode` null | string

`naceCode` null | string

`street` null | string

`houseNumber` null | string

`orientationNumber` string | null

`city` null | string

`postalCode` null | string

`country` string | null

`phone` null | string

`email` null | string

`contactFirstName` string | null

`contactLastName` string | null

`contactPhone` string | null

`signerFirstName` null | string

`signerLastName` null | string

`signerRole` null | string

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

`createdAt` string date-time

`updatedAt` string date-time

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`rows` array | object

`country` null | string povinné

`vatId` string

`code` integer | null

`count` integer

`valueHaler` integer | null

`contactName` null | string

`value` integer

`storno` boolean

`rate` integer

`rateType` string

`supplyType` string

`baseCents` integer

`vatCents` integer

`sector` null | string

`cents` integer

`identifiedPerson` boolean

`cumulativeRows` object

`attachments` object\[\]

`section` string povinné

`title` null | string povinné

`lines` string\[\] povinné

`row` string

`adjustmentDetails` object\[\]

`id` string povinné

`kind` string povinné

`row` integer povinné

`values` object povinné

`base` integer

`full` integer

`deductible` integer

`value` integer

`note` null | string povinné

`source` string povinné

`settlement` null | object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`entriesCount` integer

`issues` object\[\] povinné

`severity` string povinné

`code` null | string povinné

`message` null | string povinné

`documentId` null | string

`number` null | string

`statement` object

`A1` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`code` null | string povinné

`baseHaler` integer | null povinné

`A2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`country` null | string povinné

`vatId` string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`base1` integer povinné

`vat1` integer povinné

`A3` any\[\] povinné

`A4` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`regime` integer povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`A5` object povinné

`base1` integer

`vat1` integer

`base2` integer

`vat2` integer

`B1` any\[\] povinné

`B2` object\[\] povinné

`documentId` null | string povinné

`number` null | string povinné

`contactName` null | string povinné

`dic` null | string povinné

`evidenceNumber` null | string povinné

`date` string povinné date

`proportional` string povinné

`badDebt` string povinné

`base1` integer povinné

`vat1` integer povinné

`base2` integer

`vat2` integer

`B3` object povinné

`base1` integer

`vat1` integer

`C` object povinné

`obrat23` integer povinné

`obrat5` integer povinné

`pln23` integer povinné

`pln5` integer povinné

`plnRezPren` integer povinné

`rezPren23` integer povinné

`rezPren5` integer povinné

`celkZdA2` integer povinné

`empty` boolean

`allRows` object\[\]

`country` null | string povinné

`vatId` string povinné

`code` integer | null povinné

`count` integer povinné

`valueHaler` integer | null povinné

`contactName` null | string povinné

`value` integer povinné

`worksheet` object

`year` integer povinné

`rows` object povinné

`annex2` any

Null in every recorded response.

`annex3` any

Null in every recorded response.

`cfcCredit` any

Null in every recorded response.

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`2` integer povinné

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` object\[\] povinné

`education` object\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`disabledEmployees` number povinné

`severelyDisabledEmployees` number povinné

`tableI` null | object

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`row320` integer povinné

`states` object\[\] povinné

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` integer | null povinné

`currency` null | string povinné

`losses` object\[\] povinné

`to` string povinné date

`from` string povinné date

`lossKc` integer povinné

`lossYear` integer povinné

`usedNowKc` integer povinné

`remainingKc` integer povinné

`usedPriorKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`links` object povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`transition` object povinné

`depreciationDifferenceKc` integer

`tableC` object

`inputs` object povinné

`wageTaxPaidKc` integer

`employmentIncomeKc` integer

`losses` object\[\]

`giftsKc` integer

`accountingCategory` string

`tableC` object

`foreignTax` object

`taxCredits` object

`turnoverKc` integer

`researchClaims` object\[\]

`educationClaims` object\[\]

`employeesAverage` integer

`otherAdditionsKc` integer

`business` object

`flatRatePercent` integer

`otherIncreaseKc` integer

`specialAttachments` object\[\]

`separateBaseIncomes` object\[\]

`otherDeductionsKc` integer

`additionalReasons` string

`foreign` object

`publication` object

`statementFiles` string\[\]

`rental` object

`spouse` boolean | object

`children` object\[\]

`employers` object\[\]

`otherIncome` object\[\]

`separateBase` object

`bonusEligible` boolean

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` object\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`other` object povinné

`rental` object povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`attachment4` null | object

`foreignCertificates` object\[\]

`authority` string povinné

`country` null | string povinné

`taxLocal` integer povinné

`taxKc` integer povinné

`incomeKc` integer povinné

`estimated` boolean povinné

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`lastName` null | string

`birthDate` null | string date

`firstName` null | string

`childUnder3` boolean

`statementsNeeded` boolean

`publicBenefit` any

Null in every recorded response.

`separateBase` null | object

`331` integer povinné

`332` integer povinné

`333` integer povinné

`334` integer povinné

`335` integer povinné

`items` object\[\] povinné

`source` object

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`previous` null | object

`taxKc` integer povinné

`lossKc` integer povinné

`statements` null | object

`assets` object\[\] povinné

`c_radku` integer povinné

`kc_brutto` integer povinné

`kc_korekce` integer | null povinné

`kc_netto` integer povinné

`kc_netto_min` integer | null povinné

`liabilities` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`income` object\[\] povinné

`c_radku` integer povinné

`kc_sled` integer | null povinné

`kc_min` integer | null povinné

`asOf` string povinné date

`range` string povinné

`beforeTaxKc` integer povinné

`corrections` object\[\]

`year` integer povinné

`country` null | string povinné

`quarter` integer | null povinné

`correctionCents` integer povinné

`eurRate` integer | null

`eurRateDate` null | string date

`scheme` string

`schemeNumber` null | string

`intermediaryNumber` any

Null in every recorded response.

`internalNumber` string

`totalVatCents` integer

`totalDueCents` integer

`bank` object

`iban` string | null povinné

`accountName` string povinné

`overview` object

`year` integer povinné

`rows` object povinné

`participatesSide` boolean

`decisiveAmountKc` integer | null

`balanceKc` integer povinné

`nextAdvanceKc` integer | null povinné

`nextYear` integer povinné

`issues` any\[\] povinné

`taxBase` object

`taxBaseKc` integer povinné

`source` string povinné

`filingId` null | string povinné

`status` null | string povinné

`deadlines` object

`taxDue` string povinné date

`overview` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`balanceDue` string povinné date

`minimum` object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`minimumNext` null | object

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

`computed` object

`year` integer povinné

`land` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number

`coefficient` integer | null

`parcelNumber` integer povinné

`inflation` integer povinné

`computed` object povinné

`cadastralCode` integer

`municipalityCode` integer

`pricePerM2` integer

`exemptAreaM2` integer

`exemptions` object\[\]

`buildings` object\[\]

`type` string povinné

`areaM2` integer povinné

`ratePerM2` number povinné

`houseNumber` integer | null povinné

`parcelNumber` integer povinné

`cadastralCode` integer povinné

`businessAreaM2` integer povinné

`municipalityCode` integer povinné

`inflation` integer povinné

`computed` object povinné

`landTax` integer

`buildingTax` integer

`total` integer povinné

`payments` object\[\]

`due` string povinné date

`amountKc` integer povinné

`returnDue` string date

`rows` object\[\]

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`payable` integer

`reasons` any

Null in every recorded response.

`notice` object

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`totalCents` integer povinné

`limit` object

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`evidenceNumber` null | string

`exceededOn` null | string date

`totalCents` integer

`due` string date

`publication` null | object

`pr11_rozv` string povinné

`pr11_vzz` string povinné

`pr11_puz` string povinné

`pr11_pzvk` string povinné

`pr11_ppt` string povinné

`pr11_uzmus` string povinné

`pr11_email` string povinné

`xmlIssues` object\[\]

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lockedAt` null | string date-time

`locked` boolean

`changedSinceLock` boolean

`events` object\[\]

`object` "tax\_filing\_event" povinné

`id` string povinné

`action` string povinné

`field` null | string povinné

`oldValue` null | string povinné

`newValue` null | string povinné

`reason` null | string povinné

`actorId` null | string povinné

`createdAt` string povinné date-time

`rowLabels` object

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "reason": "string"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `download-tax-filing-xml`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

Vrací soubor application/xml.

```bash
curl https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/xml \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/xml', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/filings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/xml",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content
```

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

GET `/v1/tax/income`

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

Nástroj MCP: `get-income-tax-worksheet`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`form` string povinné

`year` integer povinné

`filingId` null | string povinné

`filingStatus` null | string

`worksheet` object povinné

`year` integer povinné

`rows` object povinné

`annex2` null | object

`271` integer povinné

`272` integer povinné

`273` integer povinné

`274` integer povinné

`282` integer povinné

`284` integer povinné

`286` integer povinné

`288` integer povinné

`290` integer povinné

`periods` object\[\] povinné

`to` string povinné date

`from` string povinné date

`days` integer povinné

`annex3` null | object

`a` object povinné

`b` object povinné

`totalA` integer povinné

`totalB` integer povinné

`tableI` any povinné

Null in every recorded response.

`tableII` any povinné

Null in every recorded response.

`tableIII` object povinné

`rows` object povinné

`priceKc` integer povinné

`expenseKc` integer povinné

`differenceKc` integer povinné

`companies` any\[\] povinné

`tableIVKc` integer povinné

`tableV` object povinné

`1` integer povinné

`2` integer povinné

`claims` any\[\] povinné

`cfcCredit` null | object

`states` object\[\] povinné

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`6` integer povinné

`7` integer povinné

`country` null | string povinné

`r6` integer povinné

`r7` integer povinné

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`1` integer

`2` integer

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` any\[\] povinné

`education` any\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` any

Null in every recorded response.

`tableI` any

Null in every recorded response.

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` any povinné

Null in every recorded response.

`currency` null | string povinné

`losses` object\[\] povinné

`from` string povinné date

`to` string povinné date

`lossKc` integer povinné

`usedPriorKc` integer povinné

`usedNowKc` integer povinné

`lossYear` integer povinné

`remainingKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`relatedPartyAdvances` object

`increaseKc` integer povinné

`decreaseKc` integer povinné

`rows` object\[\] povinné

`publicBenefit` object

`treatment` null | string povinné

`activities` object\[\] povinné

`outsideHaler` integer povinné

`exemptHaler` integer povinné

`costBackHaler` integer povinné

`taxedHaler` integer povinné

`filingRequired` boolean povinné

`issues` object\[\] povinné

`inputs` object povinné

`flatRatePercent` integer

`fundPeriods` object\[\]

`to` string povinné date

`from` string povinné date

`antiAvoidance` object

`hybridKc` integer povinné

`transfersOther` object povinné

`otherAdditionsKc` integer

`cfcForeignTaxStates` object\[\]

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`useAssetLinks` boolean

`useTransportFlatRate` boolean

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`rental` object

`incomeKc` integer povinné

`flat` boolean povinné

`otherIncome` object\[\]

`kind` string povinné

`description` null | string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`foreign` object

`credits` object\[\] povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`childUnder3` boolean povinné

`firstName` null | string povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`children` object\[\]

`order` integer povinné

`months` integer

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`employmentIncomeKc` integer

`wageTaxPaidKc` integer

`losses` object\[\]

`from` string povinné date

`to` string povinné date

`lossKc` integer povinné

`usedPriorKc` integer povinné

`usedNowKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`bonusEligible` boolean

`publicBenefit` object

`enabled` boolean povinné

`standard` string

`activities` object\[\]

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` any\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`rental` object povinné

`201` integer povinné

`202` integer povinné

`203` integer povinné

`204` integer povinné

`205` integer povinné

`206` integer povinné

`201a` integer povinné

`flat` boolean povinné

`other` object povinné

`207` integer povinné

`208` integer povinné

`209` integer povinné

`items` object\[\] povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`321` integer povinné

`322` integer povinné

`323` integer povinné

`324` number povinné

`325` number povinné

`326` integer povinné

`327` integer povinné

`country` null | string povinné

`attachment4` null | object

`foreignCertificates` any\[\]

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`childUnder3` boolean

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`statementsNeeded` boolean

`publicBenefit` null | object

`standard` string povinné

`reductionKc` integer povinné

`treatment` null | string povinné

`activities` object\[\] povinné

`name` null | string povinné

`economic` boolean povinné

`subsidyHaler` integer povinné

`giftHaler` integer povinné

`membershipHaler` integer povinné

`interestHaler` integer povinné

`otherIncomeHaler` integer povinné

`costHaler` integer povinné

`outsideBase` boolean povinné

`taxableIncomeHaler` integer povinné

`costAllowedHaler` integer povinné

`costDisallowedHaler` integer povinné

`filingRequired` boolean povinné

`reductionLimitKc` integer povinné

`savedTaxKc` integer povinné

`useBy` string povinné date

`separateBase` any

Null in every recorded response.

`deadlines` object

`paper` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`electronic` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`adviser` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`advancePlan` object

`frequency` string povinné

`amountKc` integer povinné

`dates` object\[\] povinné

`statutory` string povinné date

`due` string povinné date

`basisKc` integer povinné

`advances` object\[\]

`id` string povinné

`taxYear` integer povinné

`dueOn` null | string povinné date

`amountKc` integer povinné

`paidOn` null | string povinné date

```bash
curl https://api.damedoklad.cz/v1/tax/income \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/income', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/income",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/income`

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

Nástroj MCP: `update-income-tax-inputs`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Tělo požadavku

`publicBenefit` object

`enabled` boolean povinné

`taxTreatment` "general" | "all\_income"

`standard` "general" | "research" | "none"

`membershipExempt` boolean

`giftsExempt` boolean

`alwaysTaxable` string\[\]

`withheldInterestKc` integer min 0 max 9007199254740991

`reductionKc` integer | null

`priorUnusedSavingKc` integer min 0 max 9007199254740991

`activities` object\[\]

`name` string povinné max 120 chars

`economic` boolean

`subsidyKc` integer min 0 max 9007199254740991

`giftKc` integer min 0 max 9007199254740991

`membershipKc` integer min 0 max 9007199254740991

`interestKc` integer min 0 max 9007199254740991

`incomeKc` integer min 0 max 9007199254740991

`costKc` integer min 0 max 9007199254740991

`flatRatePercent` 80 | 60 | 40 | 30 | null

`employmentIncomeKc` integer min 0 max 9007199254740991

`employers` object\[\]

`name` string povinné max 255 chars

`incomeKc` integer povinné min 0 max 9007199254740991

`advanceKc` integer min 0 max 9007199254740991

`bonusKc` integer min 0 max 9007199254740991

`foreignEmploymentTaxKc` integer min 0 max 9007199254740991

`capitalBaseKc` integer min -9007199254740991 max 9007199254740991

`rentalBaseKc` integer min -9007199254740991 max 9007199254740991

`otherBaseKc` integer min -9007199254740991 max 9007199254740991

`rental` object | null

`incomeKc` integer povinné min 0 max 9007199254740991

`realEstateKc` integer min 0 max 9007199254740991

`expensesKc` integer min 0 max 9007199254740991

`flat` boolean

`increaseKc` integer min 0 max 9007199254740991

`decreaseKc` integer min 0 max 9007199254740991

`otherIncome` object\[\]

`kind` "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" povinné

`description` string max 50 chars

`incomeKc` integer povinné min 0 max 9007199254740991

`expensesKc` integer min 0 max 9007199254740991

`code` "P" | "S" | "Z" | "N"

`foreign` object | null

`exemptEmploymentKc` integer min 0 max 9007199254740991

`exemptOtherKc` integer min 0 max 9007199254740991

`credits` object\[\]

`country` string povinné 2 chars

`incomeKc` integer povinné min 0 max 9007199254740991

`expensesKc` integer min 0 max 9007199254740991

`taxPaidKc` integer povinné min 0 max 9007199254740991

`certificates` object\[\]

`authority` string povinné max 255 chars

`country` string povinné 2 chars

`taxLocal` integer min 0 max 9007199254740991

`taxKc` integer povinné min 0 max 9007199254740991

`incomeKc` integer povinné min -9007199254740991 max 9007199254740991

`estimated` boolean

`separateBase` object | null

`partnerIncomeKc` integer min 0 max 9007199254740991

`capitalIncomeKc` integer min 0 max 9007199254740991

`prizeIncomeKc` integer min 0 max 9007199254740991

`prizeExpensesKc` integer min 0 max 9007199254740991

`lotteryIncomeKc` integer min 0 max 9007199254740991

`lotteryExpensesKc` integer min 0 max 9007199254740991

`creditIncomeKc` integer min 0 max 9007199254740991

`creditTaxKc` integer min 0 max 9007199254740991

`business` object | null

`increaseKc` integer min 0 max 9007199254740991

`decreaseKc` integer min 0 max 9007199254740991

`months` integer min 0 max 12

`realEstateDepreciationKc` integer min 0 max 9007199254740991

`cooperating` object\[\]

`firstName` string povinné max 36 chars

`lastName` string povinné max 36 chars

`dic` string povinné

VAT number (DIČ), for example CZ12345678.

`sharePct` number povinné min 0 max 100

`months` integer min 1 max 12

`relation` "spouse" | "household" | "family" povinné

`receivedShare` object | null

`firstName` string povinné max 36 chars

`lastName` string povinné max 36 chars

`dic` string povinné

VAT number (DIČ), for example CZ12345678.

`sharePct` number min 0 max 100

`incomeKc` integer povinné min 0 max 9007199254740991

`expensesKc` integer povinné min 0 max 9007199254740991

`lossKc` integer min 0 max 9007199254740991

`losses` object\[\]

`from` string YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string YYYY-MM-DD

Date as YYYY-MM-DD.

`period` string max 22 chars

`lossKc` integer povinné min 0 max 9007199254740991

`usedPriorKc` integer min 0 max 9007199254740991

`usedNowKc` integer povinné min 0 max 9007199254740991

`ico` string

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

`giftsKc` integer min 0 max 9007199254740991

`interestKc` integer min 0 max 9007199254740991

`pensionKc` integer min 0 max 9007199254740991

`lifeInsuranceKc` integer min 0 max 9007199254740991

`longTermProductKc` integer min 0 max 9007199254740991

`longTermCareKc` integer min 0 max 9007199254740991

`researchKc` integer min 0 max 9007199254740991

`educationKc` integer min 0 max 9007199254740991

`spouse` boolean | object | null

`disability12` boolean | integer

`disability3` boolean | integer

`ztpp` boolean | integer

`children` object\[\]

`order` integer povinné min 1 max 9007199254740991

`months` integer min 0 max 12

`monthsZtpp` integer min 0 max 12

`ztpp` boolean

`firstName` string max 36 chars

`lastName` string max 36 chars

`birthNumber` string

`birthDate` string YYYY-MM-DD

Date as YYYY-MM-DD.

`bonusEligible` boolean | null

`wageTaxPaidKc` integer min 0 max 9007199254740991

`monthlyBonusPaidKc` integer min 0 max 9007199254740991

`unlawfulReductionsKc` integer min -9007199254740991 max 9007199254740991

`otherAdditionsKc` integer min -9007199254740991 max 9007199254740991

`depreciationDifferenceKc` integer min -9007199254740991 max 9007199254740991

`taxDepreciationExcessKc` integer min 0 max 9007199254740991

`otherIncreaseKc` integer min -9007199254740991 max 9007199254740991

`otherDeductionsKc` integer min -9007199254740991 max 9007199254740991

`creditsKc` integer min 0 max 9007199254740991

`tableC` object

`researchClaims` object\[\]

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`claimKc` integer povinné min 0 max 9007199254740991

`usedPriorKc` integer min 0 max 9007199254740991

`usedNowKc` integer povinné min 0 max 9007199254740991

`educationClaims` object\[\]

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`claimKc` integer povinné min 0 max 9007199254740991

`usedPriorKc` integer min 0 max 9007199254740991

`usedNowKc` integer povinné min 0 max 9007199254740991

`taxCredits` object | null

`disabledEmployees` number min 0

`severelyDisabledEmployees` number min 0

`enforcementKc` integer min 0 max 9007199254740991

`investmentKc` integer min 0 max 9007199254740991

`foreignExemptKc` integer min -9007199254740991 max 9007199254740991

`foreignTax` object | null

`fullCreditKc` integer min 0 max 9007199254740991

`states` object\[\]

`country` string povinné 2 chars

`taxPaidKc` integer povinné min 0 max 9007199254740991

`incomeKc` integer povinné min 0 max 9007199254740991

`expensesKc` integer min 0 max 9007199254740991

`limitedPartnership` object | null

`1` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`2` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`3` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`4` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`5` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`7` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`9` object

`generalKc` integer min -9007199254740991 max 9007199254740991

`limitedKc` integer min -9007199254740991 max 9007199254740991

`turnoverKc` integer min -9007199254740991 max 9007199254740991

`employeesAverage` integer min 0 max 9007199254740991

`fundPeriods` object\[\]

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`antiAvoidance` object | null

`borrowing` object | null

`priorIncreasesKc` integer min 0 max 9007199254740991

`priorDecreasesKc` integer min 0 max 9007199254740991

`excessKc` integer min -9007199254740991 max 9007199254740991

`taxEbitdaKc` integer min -9007199254740991 max 9007199254740991

`transfersTreaty` object | null

`hmot` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`nehm` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`fin` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`zas` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`pohl` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`ost` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`transfersOther` object | null

`hmot` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`nehm` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`fin` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`zas` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`pohl` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`ost` object

`priceKc` integer min 0 max 9007199254740991

`expenseKc` integer min 0 max 9007199254740991

`transferInIncreaseKc` integer min 0 max 9007199254740991

`transferInDecreaseKc` integer min 0 max 9007199254740991

`hybridKc` integer min 0 max 9007199254740991

`cfcCompanies` object\[\]

`name` string povinné max 255 chars

`taxId` string max 20 chars

ID of the tax.

`country` string povinné 2 chars

`amountKc` integer povinné min 0 max 9007199254740991

`cfcClaims` object\[\]

`name` string povinné max 255 chars

`taxId` string max 20 chars

ID of the tax.

`country` string povinné 2 chars

`rows` object\[\] povinné

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`claimKc` integer povinné min 0 max 9007199254740991

`usedPriorKc` integer min 0 max 9007199254740991

`usedNowKc` integer min 0 max 9007199254740991

`cfcForeignTaxStates` object\[\]

`country` string povinné 2 chars

`taxPaidKc` integer povinné min 0 max 9007199254740991

`incomeKc` integer povinné min 0 max 9007199254740991

`expensesKc` integer min 0 max 9007199254740991

`cfcFundTaxKc` integer min 0 max 9007199254740991

`separateBaseIncomes` object\[\]

`description` string povinné max 120 chars

`country` string povinné 2 chars

`kind` "dividend" | "settlement" povinné

`incomeKc` integer povinné min 0 max 9007199254740991

`acquisitionCostKc` integer min 0 max 9007199254740991

`foreignTaxKc` integer min 0 max 9007199254740991

`specialAttachments` object\[\]

`row` string povinné

`text` string povinné max 4000 chars

`publication` object | null

`email` string povinné max 255 chars email

`balanceSheet` boolean

`incomeStatement` boolean

`notes` boolean

`cashFlow` boolean

`equityChanges` boolean

`statementFiles` "notes" | "cashFlow" | "equityChanges"\[\]

`investmentIncentive` object | null

`section` "35a" | "35b" povinné

`decisionNumber` integer min 0 max 999

`decisionPart` integer min 0 max 9999

`decisionDate` string YYYY-MM-DD

Date as YYYY-MM-DD.

`firstPeriod` string max 30 chars

`capKc` integer min 0 max 9007199254740991

`usedPriorKc` integer min 0 max 9007199254740991

`interestExcessKc` integer min 0 max 9007199254740991

`violationKc` integer min 0 max 9007199254740991

`startingS2Kc` integer min 0 max 9007199254740991

`indexPercent` number

`advancesPaidKc` integer min 0 max 9007199254740991

`useAssetLinks` boolean

`useTransportFlatRate` boolean

`statementStructure` "full" | "short" | "micro"

`accountingCategory` "M" | "L" | "S" | "V" | null

`additionalReasons` string max 4000 chars

### Odpověď · 200

`form` string povinné

`year` integer povinné

`filingId` null | string povinné

`filingStatus` null | string

`worksheet` object povinné

`year` integer povinné

`rows` object povinné

`annex2` null | object

`271` integer povinné

`272` integer povinné

`273` integer povinné

`274` integer povinné

`282` integer povinné

`284` integer povinné

`286` integer povinné

`288` integer povinné

`290` integer povinné

`periods` object\[\] povinné

`to` string povinné date

`from` string povinné date

`days` integer povinné

`annex3` null | object

`a` object povinné

`b` object povinné

`totalA` integer povinné

`totalB` integer povinné

`tableI` any povinné

Null in every recorded response.

`tableII` any povinné

Null in every recorded response.

`tableIII` object povinné

`rows` object povinné

`priceKc` integer povinné

`expenseKc` integer povinné

`differenceKc` integer povinné

`companies` any\[\] povinné

`tableIVKc` integer povinné

`tableV` object povinné

`1` integer povinné

`2` integer povinné

`claims` any\[\] povinné

`cfcCredit` null | object

`states` object\[\] povinné

`1` integer povinné

`2` integer povinné

`3` integer povinné

`4` integer povinné

`5` integer povinné

`6` integer povinné

`7` integer povinné

`country` null | string povinné

`r6` integer povinné

`r7` integer povinné

`incentive` any

Null in every recorded response.

`tableA` object\[\]

`name` null | string povinné

`amountKc` integer povinné

`tableB` null | object

`1` integer

`2` integer

`total` integer povinné

`accountingKc` integer povinné

`tableC` object

`tableF` object

`research` any\[\] povinné

`education` any\[\] povinné

`researchRemainingKc` integer povinné

`educationRemainingKc` integer povinné

`tableG` integer

`tableH` any

Null in every recorded response.

`tableI` any

Null in every recorded response.

`tableJ` any

Null in every recorded response.

`tableK` object

`turnoverKc` integer povinné

`employeesAverage` any povinné

Null in every recorded response.

`currency` null | string povinné

`losses` object\[\] povinné

`from` string povinné date

`to` string povinné date

`lossKc` integer povinné

`usedPriorKc` integer povinné

`usedNowKc` integer povinné

`lossYear` integer povinné

`remainingKc` integer povinné

`remainingLossKc` integer povinné

`issues` object\[\] povinné

`code` null | string povinné

`severity` string povinné

`message` null | string povinné

`lossKc` integer

`taxKc` integer povinné

`advancesPaidKc` integer

`payableKc` integer povinné

`lastKnownTaxKc` integer povinné

`source` object povinné

`kind` string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`resultKc` integer povinné

`nonDeductibleKc` integer povinné

`exemptIncomeKc` integer povinné

`nonDeductibleGroups` object\[\] povinné

`name` null | string povinné

`amountKc` integer povinné

`links` object povinné

`assets` object povinné

`allowances` object povinné

`transition` object povinné

`transportKc` integer povinné

`transportVehicles` integer povinné

`wagesKc` integer povinné

`useAssetLinks` boolean povinné

`useTransportFlatRate` boolean povinné

`previousLosses` any\[\] povinné

`allowances` object povinné

`addBackKc` integer povinné

`releasedKc` integer povinné

`transition` object povinné

`increaseKc` integer povinné

`decreaseKc` integer povinné

`depreciationDifferenceKc` integer

`tableC` object

`relatedPartyAdvances` object

`increaseKc` integer povinné

`decreaseKc` integer povinné

`rows` object\[\] povinné

`publicBenefit` object

`treatment` null | string povinné

`activities` object\[\] povinné

`outsideHaler` integer povinné

`exemptHaler` integer povinné

`costBackHaler` integer povinné

`taxedHaler` integer povinné

`filingRequired` boolean povinné

`issues` object\[\] povinné

`inputs` object povinné

`flatRatePercent` integer

`fundPeriods` object\[\]

`to` string povinné date

`from` string povinné date

`antiAvoidance` object

`hybridKc` integer povinné

`transfersOther` object povinné

`otherAdditionsKc` integer

`cfcForeignTaxStates` object\[\]

`country` null | string povinné

`incomeKc` integer povinné

`taxPaidKc` integer povinné

`expensesKc` integer povinné

`useAssetLinks` boolean

`useTransportFlatRate` boolean

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`rental` object

`incomeKc` integer povinné

`flat` boolean povinné

`otherIncome` object\[\]

`kind` string povinné

`description` null | string povinné

`incomeKc` integer povinné

`expensesKc` integer povinné

`foreign` object

`credits` object\[\] povinné

`separateBase` object

`capitalIncomeKc` integer povinné

`spouse` boolean | object

`months` integer povinné

`incomeKc` integer povinné

`childUnder3` boolean povinné

`firstName` null | string povinné

`lastName` null | string povinné

`birthDate` null | string povinné date

`children` object\[\]

`order` integer povinné

`months` integer

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`employmentIncomeKc` integer

`wageTaxPaidKc` integer

`losses` object\[\]

`from` string povinné date

`to` string povinné date

`lossKc` integer povinné

`usedPriorKc` integer povinné

`usedNowKc` integer povinné

`giftsKc` integer

`accountingCategory` string

`bonusEligible` boolean

`publicBenefit` object

`enabled` boolean povinné

`standard` string

`activities` object\[\]

`regime` string

`flatRatePercent` integer | null

`attachment1` object

`months` integer | null povinné

`depreciationKc` integer povinné

`realEstateDepreciationKc` integer povinné

`wagesKc` integer povinné

`cooperating` any\[\] povinné

`receivedShare` any povinné

Null in every recorded response.

`attachment2` null | object

`rental` object povinné

`201` integer povinné

`202` integer povinné

`203` integer povinné

`204` integer povinné

`205` integer povinné

`206` integer povinné

`201a` integer povinné

`flat` boolean povinné

`other` object povinné

`207` integer povinné

`208` integer povinné

`209` integer povinné

`items` object\[\] povinné

`attachment3` null | object

`311` any povinné

Null in every recorded response.

`312` any povinné

Null in every recorded response.

`313` any povinné

Null in every recorded response.

`314` any povinné

Null in every recorded response.

`315` any povinné

Null in every recorded response.

`316` any povinné

Null in every recorded response.

`328` integer povinné

`329` integer povinné

`330` integer povinné

`states` object\[\] povinné

`321` integer povinné

`322` integer povinné

`323` integer povinné

`324` number povinné

`325` number povinné

`326` integer povinné

`327` integer povinné

`country` null | string povinné

`attachment4` null | object

`foreignCertificates` any\[\]

`spouse` object

`months` integer povinné

`monthsZtpp` integer povinné

`children` object\[\]

`order` integer povinné

`months` integer

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`employers` object\[\]

`name` null | string povinné

`incomeKc` integer povinné

`advanceKc` integer povinné

`bonus` object

`wouldBeKc` integer povinné

`thresholdKc` integer povinné

`incomeKc` integer povinné

`incomeTestMet` boolean povinné

`confirmed` boolean | null povinné

`spouseDetails` object

`months` integer

`incomeKc` integer

`childUnder3` boolean

`firstName` null | string

`lastName` null | string

`birthDate` null | string date

`statementsNeeded` boolean

`publicBenefit` null | object

`standard` string povinné

`reductionKc` integer povinné

`treatment` null | string povinné

`activities` object\[\] povinné

`name` null | string povinné

`economic` boolean povinné

`subsidyHaler` integer povinné

`giftHaler` integer povinné

`membershipHaler` integer povinné

`interestHaler` integer povinné

`otherIncomeHaler` integer povinné

`costHaler` integer povinné

`outsideBase` boolean povinné

`taxableIncomeHaler` integer povinné

`costAllowedHaler` integer povinné

`costDisallowedHaler` integer povinné

`filingRequired` boolean povinné

`reductionLimitKc` integer povinné

`savedTaxKc` integer povinné

`useBy` string povinné date

`separateBase` any

Null in every recorded response.

`deadlines` object

`paper` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`electronic` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`adviser` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`advancePlan` object

`frequency` string povinné

`amountKc` integer povinné

`dates` object\[\] povinné

`statutory` string povinné date

`due` string povinné date

`basisKc` integer povinné

`advances` object\[\]

`id` string povinné

`taxYear` integer povinné

`dueOn` null | string povinné date

`amountKc` integer povinné

`paidOn` null | string povinné date

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/income \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "publicBenefit": {
    "enabled": false
  },
  "flatRatePercent": 80,
  "employmentIncomeKc": 0
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/income', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "publicBenefit": {
      "enabled": false
    },
    "flatRatePercent": 80,
    "employmentIncomeKc": 0
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/income",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "publicBenefit": {
            "enabled": False
        },
        "flatRatePercent": 80,
        "employmentIncomeKc": 0
    },
)
data = response.json()
```

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

POST `/v1/tax/income/advances`

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

Nástroj MCP: `generate-income-advances`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`frequency` string povinné

`amountKc` integer povinné

`basisKc` integer povinné

`dates` object\[\] povinné

`statutory` string povinné date

`due` string povinné date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/income/advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/income/advances', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

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

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

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

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

Nástroj MCP: `mark-income-advance`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`paidOn` string | null povinné

Date as YYYY-MM-DD.

### Odpověď · 200

`id` string povinné

`dueOn` string povinné date

`amountKc` integer povinné

`paidOn` null | string povinné date

```bash
curl -X PATCH https://api.damedoklad.cz/v1/tax/income/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "paidOn": "2026-10-30"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/income/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "paidOn": "2026-10-30"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/tax/income/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "paidOn": "2026-10-30"
    },
)
data = response.json()
```

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

GET `/v1/tax/margin`

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

Nástroj MCP: `get-margin-report`

### Parametry dotazu

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`from` string povinné date

`to` string povinné date

`rows` object\[\] povinné

`documentType` null | string povinné

`documentId` null | string povinné

`number` null | string povinné

`taxPointDate` null | string povinné date

`contactName` null | string povinné

`vatMode` string povinné

`section` string povinné

`grossHaler` integer povinné

`purchaseHaler` integer povinné

`marginHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`totals` object povinné

`marginHaler` integer povinné

`vatHaler` integer | null povinné

```bash
curl https://api.damedoklad.cz/v1/tax/margin \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-margin-document`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`documentType` null | string povinné

`documentId` null | string povinné

`number` null | string povinné

`vatMode` string povinné

`status` string povinné

`complete` boolean povinné

`lines` object\[\] povinné

`position` integer | null povinné

`description` null | string povinné

`vatRate` integer povinné

`grossHaler` integer povinné

`purchaseHaler` integer | null povinné

`exemptPercent` integer povinné

`marginHaler` integer

`baseHaler` integer | null

`vatHaler` integer | null

`outsideMarginHaler` integer

```bash
curl https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `set-margin-document-lines`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`lines` object\[\] povinné

`position` integer povinné min 0 max 9007199254740991

`purchaseHaler` integer povinné min 0 max 9007199254740991

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

`exemptPercent` number min 0 max 100

`note` string max 240 chars

### Odpověď · 200

`documentType` null | string povinné

`documentId` null | string povinné

`number` null | string povinné

`vatMode` string povinné

`status` string povinné

`complete` boolean povinné

`lines` object\[\] povinné

`position` integer | null povinné

`description` null | string povinné

`vatRate` integer povinné

`grossHaler` integer povinné

`purchaseHaler` integer | null povinné

`exemptPercent` integer povinné

`marginHaler` integer

`baseHaler` integer | null

`vatHaler` integer | null

`outsideMarginHaler` integer

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "lines": [
    {
      "position": 0,
      "purchaseHaler": 1210000
    }
  ]
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "lines": [
      {
        "position": 0,
        "purchaseHaler": 1210000
      }
    ]
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "lines": [
            {
                "position": 0,
                "purchaseHaler": 1210000
            }
        ]
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-margin-vehicle-sale-pdf`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`buyerName` string povinné max 200 chars

`buyerAddress` string povinné max 400 chars

`decisionReference` string povinné max 120 chars

`decisionDate` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`vehicleIdentification` string povinné max 64 chars

### Odpověď · 200

Vrací soubor application/pdf.

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/vehicle-sale', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "buyerName": "Pekárna U Lípy s.r.o.",
    "buyerAddress": "string",
    "decisionReference": "string",
    "decisionDate": "2026-10-30",
    "vehicleIdentification": "string"
  }),
});
const file = await response.arrayBuffer();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/vehicle-sale",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "buyerName": "Pekárna U Lípy s.r.o.",
        "buyerAddress": "string",
        "decisionReference": "string",
        "decisionDate": "2026-10-30",
        "vehicleIdentification": "string"
    },
)
content = response.content
```

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

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

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

Nástroj MCP: `get-margin-advance-plan`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`proformaId` string povinné

`number` null | string povinné

`totalHaler` integer | null povinné

`method` string povinné

`purchasesHaler` integer povinné

`coefficient` null | number povinné

`payments` any\[\] povinné

```bash
curl https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `set-margin-advance-plan`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`method` "paid" | "estimated" povinné

`purchasesHaler` integer povinné min 0 max 9007199254740991

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

`keepFirstCoefficient` boolean

### Odpověď · 200

`proformaId` string povinné

`number` null | string povinné

`totalHaler` integer | null povinné

`method` string povinné

`purchasesHaler` integer povinné

`coefficient` null | number povinné

`payments` any\[\] povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "paid",
  "purchasesHaler": 1210000
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "method": "paid",
    "purchasesHaler": 1210000
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/margin/advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "method": "paid",
        "purchasesHaler": 1210000
    },
)
data = response.json()
```

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

GET `/v1/tax/margin/deferred`

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

Nástroj MCP: `list-margin-deferred-deductions`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_margin\_deferred\_deduction" povinné

`id` string povinné

`receivedInvoiceId` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`vatHaler` integer | null povinné

`caseCode` string povinné

`description` null | string povinné

`status` string povinné

`saleDocumentId` null | string

`saleDocumentType` null | string

`claimedOn` null | string date

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/margin/deferred \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/deferred', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/deferred",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/margin/deferred`

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

Nástroj MCP: `create-margin-deferred-deduction`

### Tělo požadavku

`receivedInvoiceId` string povinné

ID of the received invoice. Find it with list-received-invoices.

`caseCode` "imported" | "author" | "other\_taxable" povinné

`description` string | null

### Odpověď · 201

`id` string povinné

`receivedInvoiceId` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`vatHaler` integer | null povinné

`caseCode` string povinné

`description` null | string povinné

`status` string povinné

`saleDocumentId` null | string

`saleDocumentType` null | string

`claimedOn` null | string date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "caseCode": "imported"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/deferred', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "caseCode": "imported"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/deferred",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "receivedInvoiceId": "rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "caseCode": "imported"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `claim-margin-deferred-deduction`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`saleDocumentId` string povinné

ID of the sale document.

### Odpověď · 200

`id` string povinné

`receivedInvoiceId` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`vatHaler` integer | null povinné

`caseCode` string povinné

`description` null | string povinné

`status` string povinné

`saleDocumentId` null | string

`saleDocumentType` null | string

`claimedOn` null | string date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/claim \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "saleDocumentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/claim",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "saleDocumentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `close-margin-deferred-deduction`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`receivedInvoiceId` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`vatHaler` integer | null povinné

`caseCode` string povinné

`description` null | string povinné

`status` string povinné

`saleDocumentId` null | string

`saleDocumentType` null | string

`claimedOn` null | string date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sold-in-scheme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sold-in-scheme', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/deferred/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/sold-in-scheme",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/margin/periods`

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

Nástroj MCP: `list-margin-periods`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_margin\_period" povinné

`id` string povinné

`from` string povinné date

`to` string povinné date

`purchases` object\[\] povinné

`vatRate` integer povinné

`purchaseHaler` integer povinné

`status` string povinné

`closedAt` null | string povinné date-time

`rates` object\[\] povinné

`vatRate` integer povinné

`salesHaler` integer povinné

`purchaseHaler` integer povinné

`marginHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`vatHaler` integer | null povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/margin/periods \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/periods', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/periods",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/margin/periods`

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

Nástroj MCP: `set-margin-period`

### Tělo požadavku

`date` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`purchases` object\[\] povinné

`vatRate` number povinné min 0 max 100

`purchaseHaler` integer povinné min 0 max 9007199254740991

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

`confirmedUnitLimit` true povinné

### Odpověď · 200

`id` string povinné

`from` string povinné date

`to` string povinné date

`purchases` object\[\] povinné

`vatRate` integer povinné

`purchaseHaler` integer povinné

`status` string povinné

`closedAt` null | string povinné date-time

`rates` object\[\] povinné

`vatRate` integer povinné

`salesHaler` integer povinné

`purchaseHaler` integer povinné

`marginHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`vatHaler` integer | null povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/periods \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "purchases": [
    {
      "vatRate": 21,
      "purchaseHaler": 1210000
    }
  ],
  "confirmedUnitLimit": true
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/periods', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "purchases": [
      {
        "vatRate": 21,
        "purchaseHaler": 1210000
      }
    ],
    "confirmedUnitLimit": true
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/margin/periods",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "purchases": [
            {
                "vatRate": 21,
                "purchaseHaler": 1210000
            }
        ],
        "confirmedUnitLimit": True
    },
)
data = response.json()
```

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

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

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

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

Nástroj MCP: `delete-margin-period`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `close-margin-period`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`from` string povinné date

`to` string povinné date

`purchases` object\[\] povinné

`vatRate` integer povinné

`purchaseHaler` integer povinné

`status` string povinné

`closedAt` null | string povinné date-time

`rates` object\[\] povinné

`vatRate` integer povinné

`salesHaler` integer povinné

`purchaseHaler` integer povinné

`marginHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`vatHaler` integer | null povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `reopen-margin-period`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`from` string povinné date

`to` string povinné date

`purchases` object\[\] povinné

`vatRate` integer povinné

`purchaseHaler` integer povinné

`status` string povinné

`closedAt` null | string povinné date-time

`rates` object\[\] povinné

`vatRate` integer povinné

`salesHaler` integer povinné

`purchaseHaler` integer povinné

`marginHaler` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`vatHaler` integer | null povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/periods/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/margin/purchases`

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

Nástroj MCP: `list-margin-purchases`

### Parametry dotazu

`available` "true" | "false"

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_margin\_purchase" povinné

`id` string povinné

`number` string povinné

`purchasedOn` string povinné date

`sellerKind` string povinné

`sellerName` string povinné

`sellerAddress` null | string povinné

`sellerIco` string | null povinné

`sellerDocument` null | string povinné

`contactId` string | null povinné

`receivedInvoiceId` string | null povinné

`vatMode` string povinné

`totalHaler` integer povinné

`note` string | null povinné

`lines` object\[\] povinné

`id` string povinné

`position` integer | null povinné

`description` null | string povinné

`serialNumber` null | string povinné

`purchaseHaler` integer povinné

`soldDocumentId` string | null

`soldDocumentType` string | null

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/margin/purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/purchases', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/purchases",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/margin/purchases`

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

Nástroj MCP: `create-margin-purchase`

### Tělo požadavku

`purchasedOn` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`sellerKind` "non\_taxable" | "small\_business" | "exempt\_62" | "margin\_dealer" povinné

`sellerName` string povinné max 200 chars

`sellerAddress` string | null

`sellerIco` string | null

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

`sellerDocument` string | null

`contactId` string | null

ID of the contact. Find it with list-contacts.

`vatMode` "margin\_used\_goods" | "margin\_art" | "margin\_collectibles"

`note` string | null

`recordInvoice` boolean

`lines` object\[\] povinné

`description` string povinné max 240 chars

`serialNumber` string | null

`purchaseHaler` integer povinné min 0 max 9007199254740991

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

### Odpověď · 201

`id` string povinné

`number` string povinné

`purchasedOn` string povinné date

`sellerKind` string povinné

`sellerName` string povinné

`sellerAddress` null | string povinné

`sellerIco` string | null povinné

`sellerDocument` null | string povinné

`contactId` string | null povinné

`receivedInvoiceId` string | null povinné

`vatMode` string povinné

`totalHaler` integer povinné

`note` string | null povinné

`lines` object\[\] povinné

`id` string povinné

`position` integer | null povinné

`description` null | string povinné

`serialNumber` null | string povinné

`purchaseHaler` integer povinné

`soldDocumentId` string | null

`soldDocumentType` string | null

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/margin/purchases \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "purchasedOn": "2026-10-30",
  "sellerKind": "non_taxable",
  "sellerName": "Pekárna U Lípy s.r.o.",
  "lines": [
    {
      "description": "Pečivo, říjen",
      "purchaseHaler": 1210000
    }
  ]
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/purchases', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "purchasedOn": "2026-10-30",
    "sellerKind": "non_taxable",
    "sellerName": "Pekárna U Lípy s.r.o.",
    "lines": [
      {
        "description": "Pečivo, říjen",
        "purchaseHaler": 1210000
      }
    ]
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/margin/purchases",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "purchasedOn": "2026-10-30",
        "sellerKind": "non_taxable",
        "sellerName": "Pekárna U Lípy s.r.o.",
        "lines": [
            {
                "description": "Pečivo, říjen",
                "purchaseHaler": 1210000
            }
        ]
    },
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-margin-purchase-pdf`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

Vrací soubor application/pdf.

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/purchases/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/purchases/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content
```

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

GET `/v1/tax/margin/settings`

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

Nástroj MCP: `get-margin-settings`

### Odpověď · 200

`enabled` boolean povinné

`drafts` object\[\] povinné

`documentId` null | string povinné

`documentType` null | string povinné

`contactName` null | string povinné

`issueDate` null | string povinné date

`totalHaler` integer | null povinné

`vatMode` string povinné

```bash
curl https://api.damedoklad.cz/v1/tax/margin/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/margin/settings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/margin/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/margin/settings`

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

Nástroj MCP: `set-margin-settings`

### Tělo požadavku

`enabled` boolean povinné

### Odpověď · 200

`enabled` boolean povinné

`drafts` object\[\] povinné

`documentId` null | string povinné

`documentType` null | string povinné

`contactName` null | string povinné

`issueDate` null | string povinné date

`totalHaler` integer | null povinné

`vatMode` string povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/margin/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": false
}'
```

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

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/margin/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "enabled": False
    },
)
data = response.json()
```

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

GET `/v1/tax/osvc/minimum-advances`

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

Nástroj MCP: `get-osvc-minimum-advances`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`year` integer povinné

`averageWage` integer povinné

`main` object povinné

`base` integer povinné

`advance` integer povinné

`mainStart` object povinné

`base` integer povinné

`advance` integer povinné

`side` object povinné

`base` integer povinné

`advance` integer povinné

`health` object povinné

`base` number povinné

`advance` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/osvc/minimum-advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/osvc/minimum-advances', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/osvc/minimum-advances",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/overview`

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

Nástroj MCP: `get-tax-overview`

### Parametry dotazu

`year` integer min 2016 max 2100

`month` integer min 1 max 12

`quarter` integer min 1 max 4

### Odpověď · 200

`vatPayer` boolean povinné

`frequency` string povinné

`regime` string povinné

`profileComplete` boolean povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`vatToPayKc` integer povinné

`vatRefundKc` integer povinné

`outputVatKc` integer povinné

`deductionKc` integer povinné

`documents` integer povinné

`issues` any\[\] povinné

`issuesCount` integer povinné

`deadlines` object\[\] povinné

`form` string povinné

`periodKey` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`status` string povinné

`daysLeft` integer povinné

`overdue` boolean povinné

`otherDeadlines` object\[\] povinné

`form` string povinné

`periodKey` string povinné

`year` integer povinné

`month` integer | null povinné

`quarter` integer | null povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`status` string povinné

`daysLeft` integer povinné

`overdue` boolean povinné

`upcoming` object\[\] povinné

`key` string povinné

`form` string povinné

`date` string povinné date

`period` string povinné

`overdue` boolean povinné

`labelCs` string povinné

`labelEn` string povinné

```bash
curl https://api.damedoklad.cz/v1/tax/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/overview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/overview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/profile`

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

Nástroj MCP: `get-tax-profile`

### Odpověď · 200

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`regime` string povinné

`vatPayer` boolean povinné

`vatPeriod` string povinné

`subjectType` string povinné

`firstName` null | string povinné

`lastName` null | string povinné

`title` string | null povinné

`financeOfficeCode` null | string povinné

`workplaceCode` null | string povinné

`naceCode` null | string povinné

`street` null | string povinné

`houseNumber` null | string povinné

`orientationNumber` string | null povinné

`city` null | string povinné

`postalCode` null | string povinné

`country` string | null povinné

`phone` null | string povinné

`email` null | string povinné

`contactFirstName` string | null povinné

`contactLastName` string | null povinné

`contactPhone` string | null povinné

`signerFirstName` null | string povinné

`signerLastName` null | string povinné

`signerRole` null | string povinné

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean povinné

`ossImportRegistered` boolean povinné

`ownsProperty` boolean povinné

```bash
curl https://api.damedoklad.cz/v1/tax/profile \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/profile', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/profile",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## Update the tax details filings need

PATCH `/v1/tax/profile`

Update the tax details filings need

Nástroj MCP: `update-tax-profile`

### Tělo požadavku

`subjectType` "F" | "P"

`firstName` string max 30 chars

`lastName` string max 36 chars

`title` string max 10 chars

`financeOfficeCode` string

`workplaceCode` string

`naceCode` string

`street` string max 38 chars

`houseNumber` string

`orientationNumber` string max 4 chars

`city` string max 48 chars

`postalCode` string

`country` string max 25 chars

`phone` string max 14 chars

`email` string max 255 chars email

`contactFirstName` string max 20 chars

`contactLastName` string max 36 chars

`contactPhone` string max 14 chars

`signerFirstName` string max 20 chars

`signerLastName` string max 36 chars

`signerRole` string max 40 chars

`summaryQuarterly` boolean

`ossRegistered` boolean

`ossNonEuRegistered` boolean

`ossImportRegistered` boolean

`ownsProperty` boolean

### Odpověď · 200

`name` null | string povinné

`dic` null | string povinné

`ico` null | string povinné

`regime` string povinné

`vatPayer` boolean povinné

`vatPeriod` string povinné

`subjectType` string povinné

`firstName` null | string povinné

`lastName` null | string povinné

`title` string | null povinné

`financeOfficeCode` null | string povinné

`workplaceCode` null | string povinné

`naceCode` null | string povinné

`street` null | string povinné

`houseNumber` null | string povinné

`orientationNumber` string | null povinné

`city` null | string povinné

`postalCode` null | string povinné

`country` string | null povinné

`phone` null | string povinné

`email` null | string povinné

`contactFirstName` string | null povinné

`contactLastName` string | null povinné

`contactPhone` string | null povinné

`signerFirstName` null | string povinné

`signerLastName` null | string povinné

`signerRole` null | string povinné

`summaryQuarterly` boolean povinné

`ossRegistered` boolean povinné

`ossNonEuRegistered` boolean povinné

`ossImportRegistered` boolean povinné

`ownsProperty` boolean povinné

```bash
curl -X PATCH https://api.damedoklad.cz/v1/tax/profile \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subjectType": "F",
  "firstName": "Pekárna U Lípy s.r.o.",
  "lastName": "Pekárna U Lípy s.r.o."
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/profile', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "subjectType": "F",
    "firstName": "Pekárna U Lípy s.r.o.",
    "lastName": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/tax/profile",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "subjectType": "F",
        "firstName": "Pekárna U Lípy s.r.o.",
        "lastName": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()
```

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

GET `/v1/tax/property/exemptions`

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

Nástroj MCP: `list-property-exemptions`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`kind` string povinné

`section` string povinné

`letter` string povinné

`sub` string

`label` null | string povinné

`since` integer

`timeLimited` boolean

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/property/exemptions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/property/exemptions', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/property/exemptions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/regimes/coefficient`

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

Nástroj MCP: `get-tax-coefficient`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`year` integer povinné

`coefficient` integer | null povinné

`source` null | string

`settlementCoefficient` integer | null

`settlementChangeHaler` integer | null

`settledAt` string | null

`preview` object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`settled` boolean

`numerator` integer

`exempt` integer

`reducedInput` integer

`claimed` integer

`entitled` integer

`change` integer

`applies` boolean

```bash
curl https://api.damedoklad.cz/v1/tax/regimes/coefficient \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/regimes/coefficient', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/regimes/coefficient",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/regimes/coefficient`

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

Nástroj MCP: `set-tax-coefficient`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Tělo požadavku

`coefficient` integer | null povinné

### Odpověď · 200

`year` integer povinné

`coefficient` integer | null povinné

`source` null | string

`settlementCoefficient` integer | null

`settlementChangeHaler` integer | null

`settledAt` string | null

`preview` object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`settled` boolean

`numerator` integer

`exempt` integer

`reducedInput` integer

`claimed` integer

`entitled` integer

`change` integer

`applies` boolean

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/regimes/coefficient \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "coefficient": 0
}'
```

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

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/regimes/coefficient",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "coefficient": 0
    },
)
data = response.json()
```

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

POST `/v1/tax/regimes/coefficient/settle`

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

Nástroj MCP: `settle-tax-coefficient`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`year` integer povinné

`coefficient` integer | null povinné

`source` null | string

`settlementCoefficient` integer | null

`settlementChangeHaler` integer | null

`settledAt` string | null

`preview` object

`numerator` integer povinné

`exempt` integer povinné

`reducedInput` integer povinné

`claimed` integer povinné

`coefficient` integer | null povinné

`entitled` integer povinné

`change` integer povinné

`applies` boolean povinné

`settled` boolean

`numerator` integer

`exempt` integer

`reducedInput` integer

`claimed` integer

`entitled` integer

`change` integer

`applies` boolean

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/regimes/coefficient/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/regimes/coefficient/settle', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/regimes/coefficient/settle",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/regimes/oss`

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

Nástroj MCP: `get-vat-oss`

### Parametry dotazu

`date` string YYYY-MM-DD

Date as YYYY-MM-DD.

`year` integer povinné min -9007199254740991 max 9007199254740991

`quarter` integer min 1 max 4

`month` integer min 1 max 12

`scheme` "EU" | "NON\_EU" | "IMPORT"

### Odpověď · 200

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`scheme` string povinné

`deadline` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

`period` object povinné

`year` integer povinné

`month` integer | null

`key` string povinné

`from` string povinné date

`to` string povinné date

`quarter` integer | null

`rows` object\[\] povinné

`country` null | string povinné

`rate` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`issues` any\[\] povinné

`totalVatHaler` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/regimes/oss \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/regimes/oss', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/regimes/oss",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-oss-ecb-rate`

### Parametry dotazu

`date` string YYYY-MM-DD

Date as YYYY-MM-DD.

`year` integer povinné min -9007199254740991 max 9007199254740991

`quarter` integer min 1 max 4

`month` integer min 1 max 12

### Odpověď · 200

`date` string povinné date

`rate` number povinné

`requestedFor` string povinné date

`source` string povinné

```bash
curl https://api.damedoklad.cz/v1/tax/regimes/oss/ecb-rate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/regimes/oss/ecb-rate', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/regimes/oss/ecb-rate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## Detail: režim evidence, dph

GET `/v1/tax/regimes/overview`

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

Nástroj MCP: `get-vat-regimes`

### Parametry dotazu

`year` integer min 2016 max 2100

`month` integer min 1 max 12

`quarter` integer min 1 max 4

### Odpověď · 200

`period` object povinné

`year` integer povinné

`month` integer | null povinné

`key` string povinné

`from` string povinné date

`to` string povinné date

`reverseChargeSupplied` any\[\] povinné

`reverseChargeReceived` any\[\] povinné

`selfAssessed` any\[\] povinné

`advances` any\[\] povinné

`partialDeductions` any\[\] povinné

`codes` object\[\] povinné

`code` null | string povinné

`label` null | string povinné

`countries` string\[\] povinné

`treatments` string\[\] povinné

```bash
curl https://api.damedoklad.cz/v1/tax/regimes/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/regimes/overview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/regimes/overview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/road`

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

Nástroj MCP: `get-road-tax`

### Parametry dotazu

`year` integer povinné min 2016 max 2100

### Odpověď · 200

`year` integer povinné

`rows` object\[\] povinné

`plate` string povinné

`code` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`rate` integer povinné

`months` integer povinné

`gross` integer povinné

`exemptLetter` string | null povinné

`exemptMonths` integer povinné

`exempt` integer povinné

`discount` integer povinné

`partial` integer povinné

`outside` boolean povinné

`reportable` boolean povinné

`id` string povinné

`name` string | null povinné

`total` integer povinné

`payable` integer povinné

`deadline` object povinné

`statutory` string povinné date

`due` string povinné date

`moved` boolean povinné

```bash
curl https://api.damedoklad.cz/v1/tax/road \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/road', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/road",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/sme`

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

Nástroj MCP: `get-vat-sme`

### Odpověď · 200

`registered` boolean povinné

`evidenceNumber` null | string povinné

`states` object\[\] povinné

`country` null | string povinné

`from` string povinné date

`to` any povinné

Null in every recorded response.

`adjustments` any\[\] povinné

`registeredForCzechia` boolean povinné

```bash
curl https://api.damedoklad.cz/v1/tax/sme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/sme",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/sme`

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

Nástroj MCP: `set-vat-sme`

### Tělo požadavku

`evidenceNumber` string povinné min 4 chars max 16 chars

`states` object\[\] povinné

`country` string povinné 2 chars

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string | null

Date as YYYY-MM-DD.

### Odpověď · 200

`registered` boolean povinné

`evidenceNumber` null | string povinné

`states` object\[\] povinné

`country` null | string povinné

`from` string povinné date

`to` any povinné

Null in every recorded response.

`adjustments` any\[\] povinné

`registeredForCzechia` boolean povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/sme \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "evidenceNumber": "string",
  "states": [
    {
      "country": "string",
      "from": "2026-10-30"
    }
  ]
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "evidenceNumber": "string",
    "states": [
      {
        "country": "string",
        "from": "2026-10-30"
      }
    ]
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/sme",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "evidenceNumber": "string",
        "states": [
            {
                "country": "string",
                "from": "2026-10-30"
            }
        ]
    },
)
data = response.json()
```

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

PUT `/v1/tax/sme/czechia`

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

Nástroj MCP: `set-vat-sme-for-czechia`

### Tělo požadavku

`registered` boolean povinné

### Odpověď · 200

`registered` boolean povinné

`evidenceNumber` null | string povinné

`states` object\[\] povinné

`country` null | string povinné

`from` string povinné date

`to` any povinné

Null in every recorded response.

`adjustments` any\[\] povinné

`registeredForCzechia` boolean povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/sme/czechia \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "registered": false
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme/czechia', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "registered": false
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/sme/czechia",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "registered": False
    },
)
data = response.json()
```

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

GET `/v1/tax/sme/notice`

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

Nástroj MCP: `get-vat-sme-notice`

### Parametry dotazu

`year` integer povinné min 2025 max 2100

`quarter` integer min 1 max 4

`eurRate` number

### Odpověď · 200

`year` integer povinné

`quarter` integer | null povinné

`limit` object povinné

`object` "vat\_sme\_limit" povinné

`year` integer povinné

`eurRate` integer | null povinné

`limitCents` integer povinné

`turnoverCents` integer povinné

`remainingCents` integer povinné

`previousYearCents` any povinné

Null in every recorded response.

`previousYearExceeded` boolean povinné

`exceededOn` null | string povinné date

`noticeDue` null | string povinné date

`usableUntil` null | string povinné date

`notice` null | object povinné

`year` integer povinné

`quarter` integer | null povinné

`from` string povinné date

`to` string povinné date

`due` string povinné date

`rows` object\[\] povinné

`country` null | string povinné

`sector` null | string povinné

`cents` integer povinné

`issues` any\[\] povinné

`totalCents` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/sme/notice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme/notice', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/sme/notice",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/sme/turnover`

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

Nástroj MCP: `create-vat-sme-turnover`

### Tělo požadavku

`date` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`country` string povinné 2 chars

`amountHaler` integer povinné min -9007199254740991 max 9007199254740991

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

`sector` string | null

`note` string | null

### Odpověď · 201

`id` string povinné

`date` string povinné date

`country` null | string povinné

`amountHaler` integer | null povinné

`sector` null | string povinné

`note` string | null povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/sme/turnover \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "country": "string",
  "amountHaler": 1210000
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme/turnover', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "country": "string",
    "amountHaler": 1210000
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/sme/turnover",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "country": "string",
        "amountHaler": 1210000
    },
)
data = response.json()
```

## Remove a figure entered by hand

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

Remove a figure entered by hand

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

Nástroj MCP: `delete-vat-sme-turnover`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`date` string povinné date

`country` null | string povinné

`amountHaler` integer | null povinné

`sector` null | string povinné

`note` string | null povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/sme/turnover/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/sme/turnover/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/sme/turnover/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/suppliers/check`

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

Nástroj MCP: `check-supplier-reliability`

### Tělo požadavku

`dic` string povinné min 3 chars max 14 chars

VAT number (DIČ), for example CZ12345678.

`bankAccount` string max 40 chars

### Odpověď · 200

`dic` string povinné

`status` string povinné

`source` string povinné

`unreliableSince` string | null povinné

`publishedAccounts` object\[\] povinné

`accountNumber` null | string povinné

`bankCode` null | string povinné

`iban` null | string povinné

`checkedAt` string povinné date-time

`accountPublished` any povinné

Null in every recorded response.

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/suppliers/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dic": "CZ12345678"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/suppliers/check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "dic": "CZ12345678"
    },
)
data = response.json()
```

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

GET `/v1/tax/suppliers/unpaid`

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

Nástroj MCP: `list-unpaid-supplier-checks`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_unpaid\_invoice" povinné

`id` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`dic` null | string povinné

`dueDate` null | string povinné date

`totalHaler` integer | null povinné

`account` null | string povinné

`accountPublished` boolean | null povinné

`status` null | string povinné

`source` null | string povinné

`checkedAt` null | string povinné date-time

`unreliableSince` string | null povinné

`risk` string povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/suppliers/unpaid \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/suppliers/unpaid', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/suppliers/unpaid",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/suppliers/unpaid/check`

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

Nástroj MCP: `run-unpaid-supplier-checks`

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_unpaid\_invoice" povinné

`id` string povinné

`number` null | string povinné

`supplierNumber` string povinné

`contactName` null | string povinné

`dic` null | string povinné

`dueDate` null | string povinné date

`totalHaler` integer | null povinné

`account` null | string povinné

`accountPublished` boolean | null povinné

`status` null | string povinné

`source` null | string povinné

`checkedAt` null | string povinné date-time

`unreliableSince` string | null povinné

`risk` string povinné

`total` integer povinné

`hasMore` boolean povinné

`checked` integer povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/suppliers/unpaid/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/suppliers/unpaid/check', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/suppliers/unpaid/check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## Detail: skupina, dph

GET `/v1/tax/vat-group`

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

Nástroj MCP: `get-vat-group`

### Odpověď · 200

`registered` boolean povinné

`active` boolean povinné

`role` null | string povinné

`name` null | string povinné

`dic` null | string povinné

`from` null | string povinné date

`to` any povinné

Null in every recorded response.

`applicationOn` any povinné

Null in every recorded response.

`earliestFrom` any povinné

Null in every recorded response.

`previousDic` null | string povinné

`members` object\[\] povinné

`ico` null | string povinné

`name` null | string povinné

`filesOwnReturn` boolean povinné

```bash
curl https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-group",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/vat-group`

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

Nástroj MCP: `set-vat-group`

### Tělo požadavku

`role` "representative" | "member" povinné

`name` string povinné max 200 chars

`dic` string povinné min 10 chars max 14 chars

VAT number (DIČ), for example CZ12345678.

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string | null

Date as YYYY-MM-DD.

`applicationOn` string | null

Date as YYYY-MM-DD.

`members` object\[\]

`name` string povinné max 200 chars

`ico` string | null

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

`contactId` string | null

ID of the contact. Find it with list-contacts.

### Odpověď · 200

`registered` boolean povinné

`active` boolean povinné

`role` null | string povinné

`name` null | string povinné

`dic` null | string povinné

`from` null | string povinné date

`to` any povinné

Null in every recorded response.

`applicationOn` any povinné

Null in every recorded response.

`earliestFrom` any povinné

Null in every recorded response.

`previousDic` null | string povinné

`members` object\[\] povinné

`ico` null | string povinné

`name` null | string povinné

`filesOwnReturn` boolean povinné

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "representative",
  "name": "Pekárna U Lípy s.r.o.",
  "dic": "CZ12345678",
  "from": "2026-10-30"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "role": "representative",
    "name": "Pekárna U Lípy s.r.o.",
    "dic": "CZ12345678",
    "from": "2026-10-30"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/vat-group",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "role": "representative",
        "name": "Pekárna U Lípy s.r.o.",
        "dic": "CZ12345678",
        "from": "2026-10-30"
    },
)
data = response.json()
```

## Smazání: skupina, dph

DELETE `/v1/tax/vat-group`

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

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

Nástroj MCP: `delete-vat-group`

### Odpověď · 200

`registered` boolean povinné

`active` boolean povinné

`role` null | string povinné

`name` null | string povinné

`dic` null | string povinné

`from` null | string povinné date

`to` any povinné

Null in every recorded response.

`applicationOn` any povinné

Null in every recorded response.

`earliestFrom` any povinné

Null in every recorded response.

`previousDic` null | string povinné

`members` object\[\] povinné

`ico` null | string povinné

`name` null | string povinné

`filesOwnReturn` boolean povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-group \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat-group",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat-group/contribution`

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

Nástroj MCP: `get-vat-group-contribution`

### Parametry dotazu

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`ico` null | string povinné

`name` null | string povinné

`from` string povinné date

`to` string povinné date

`entries` object\[\] povinné

`documentId` null | string povinné

`documentType` null | string povinné

`number` null | string povinné

`evidenceNumber` null | string povinné

`contactName` null | string povinné

`contactDic` string | null povinné

`contactCountry` string povinné

`date` string povinné date

`taxPointDate` null | string povinné date

`treatment` null | string povinné

`isDefaultTreatment` boolean povinné

`rate` integer povinné

`band` null | string povinné

`column` integer | null povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`deductibleVatHaler` integer povinné

`carLimited` boolean povinné

`coefficientExcluded` boolean povinné

`deduction` null | string povinné

`deductionPercent` integer | null povinné

`reverseChargeCode` string | null povinné

`specialRegime` integer povinné

`documentTotalHaler` integer povinné

`isBadDebt` boolean povinné

`khGroupId` any povinné

Null in every recorded response.

`isDebtorCorrection` boolean povinné

`offLedger` boolean povinné

`isCorrection` boolean povinné

`ossCountry` null | string povinné

`ossRate` string | null povinné

`ossRateType` string | null povinné

`ossSupplyType` string | null povinné

`ossScheme` string | null povinné

`currency` null | string povinné

`documentNetHaler` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/vat-group/contribution \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group/contribution', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-group/contribution",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## What the members handed over, as the representative has it

GET `/v1/tax/vat-group/contributions`

What the members handed over, as the representative has it

Nástroj MCP: `list-vat-group-contributions`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "vat\_group\_contribution\_saved" povinné

`id` string povinné

`ico` string | null povinné

`name` null | string povinné

`from` string povinné date

`to` string povinné date

`entryCount` integer povinné

`createdAt` string date-time

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/vat-group/contributions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group/contributions', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-group/contributions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/vat-group/contributions`

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

Nástroj MCP: `save-vat-group-contribution`

### Tělo požadavku

`ico` string | null

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

`name` string | null

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`entries` object\[\] povinné

### Odpověď · 201

`id` string povinné

`ico` string | null povinné

`name` null | string povinné

`from` string povinné date

`to` string povinné date

`entryCount` integer povinné

`createdAt` string date-time

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/vat-group/contributions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "2026-10-30",
  "to": "2026-10-30",
  "entries": [
    {}
  ]
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vat-group/contributions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "from": "2026-10-30",
        "to": "2026-10-30",
        "entries": [
            {}
        ]
    },
)
data = response.json()
```

## Remove a member’s part from the return

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

Remove a member’s part from the return

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

Nástroj MCP: `delete-vat-group-contribution`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`ico` string | null povinné

`name` null | string povinné

`from` string povinné date

`to` string povinné date

`entryCount` integer povinné

`createdAt` string date-time

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-group/contributions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group/contributions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat-group/contributions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat-group/internal`

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

Nástroj MCP: `get-vat-group-internal-supplies`

### Parametry dotazu

`from` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`from` string povinné date

`to` string povinné date

`rows` object\[\] povinné

`documentType` null | string povinné

`documentId` null | string povinné

`number` null | string povinné

`taxPointDate` null | string povinné date

`contactName` null | string povinné

`totalHaler` integer | null povinné

`totalHaler` integer | null povinné

```bash
curl https://api.damedoklad.cz/v1/tax/vat-group/internal \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group/internal', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-group/internal",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat-group/start`

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

Nástroj MCP: `get-vat-group-start`

### Parametry dotazu

`applicationOn` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`applicationOn` string povinné date

`from` string povinné date

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-group/start', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-group/start",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat-status`

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

Nástroj MCP: `get-vat-status`

### Odpověď · 200

`vatPayer` boolean povinné

`vatPeriod` string povinné

`dic` null | string povinné

`history` object\[\] povinné

`from` null | string povinné date

`vatPayer` boolean povinné

`vatPeriod` string povinné

`note` null | string povinné

`payerSince` null | string povinné date

`seatAbroad` boolean povinné

`identifiedFrom` null | string povinné date

```bash
curl https://api.damedoklad.cz/v1/tax/vat-status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-status",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/vat-status`

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

Nástroj MCP: `change-vat-status`

### Tělo požadavku

`effectiveFrom` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`vatPayer` boolean povinné

`vatPeriod` "monthly" | "quarterly"

`dic` string max 14 chars

VAT number (DIČ), for example CZ12345678.

`note` string max 240 chars

`confirm` true povinné

### Odpověď · 201

`vatPayer` boolean povinné

`vatPeriod` string povinné

`dic` null | string povinné

`history` object\[\] povinné

`from` null | string povinné date

`vatPayer` boolean povinné

`vatPeriod` string povinné

`note` null | string povinné

`payerSince` null | string povinné date

`seatAbroad` boolean povinné

`identifiedFrom` null | string povinné date

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/vat-status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "effectiveFrom": "2026-10-30",
  "vatPayer": false,
  "confirm": true
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "effectiveFrom": "2026-10-30",
    "vatPayer": false,
    "confirm": true
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vat-status",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "effectiveFrom": "2026-10-30",
        "vatPayer": False,
        "confirm": True
    },
)
data = response.json()
```

## Remove a change of VAT status entered for a date

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

Remove a change of VAT status entered for a date

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

Nástroj MCP: `delete-vat-status-change`

### Parametry v cestě

`date` string povinné

Date as YYYY-MM-DD.

### Odpověď · 200

`vatPayer` boolean povinné

`vatPeriod` string povinné

`dic` null | string povinné

`history` object\[\] povinné

`from` null | string povinné date

`vatPayer` boolean povinné

`vatPeriod` string povinné

`note` null | string povinné

`payerSince` null | string povinné date

`seatAbroad` boolean povinné

`identifiedFrom` null | string povinné date

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-status/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat-status/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/vat-status/identified`

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

Nástroj MCP: `set-vat-identified-person`

### Tělo požadavku

`from` string | null povinné

Date as YYYY-MM-DD.

### Odpověď · 200

`vatPayer` boolean povinné

`vatPeriod` string povinné

`dic` null | string povinné

`history` object\[\] povinné

`from` null | string povinné date

`vatPayer` boolean povinné

`vatPeriod` string povinné

`note` null | string povinné

`payerSince` null | string povinné date

`seatAbroad` boolean povinné

`identifiedFrom` null | string povinné date

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-status/identified \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": "2026-10-30"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status/identified', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "from": "2026-10-30"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/vat-status/identified",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "from": "2026-10-30"
    },
)
data = response.json()
```

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

GET `/v1/tax/vat-status/review`

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

Nástroj MCP: `preview-vat-status-change`

### Parametry dotazu

`effectiveFrom` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`vatPayer` "true" | "false" povinné

### Odpověď · 200

`effectiveFrom` null | string povinné date

`vatPayer` boolean povinné

`documentsToReview` object\[\] povinné

`id` string povinné

`number` null | string povinné

`taxPointDate` null | string povinné date

`totalHaler` integer | null povinné

`section79` object

`rule` string povinné

`row` integer povinné

`candidates` any\[\] povinné

`totalVatHaler` integer povinné

`section79a` object

`rule` string povinné

`row` integer povinné

`assets` any\[\] povinné

`stockValueHaler` integer povinné

```bash
curl https://api.damedoklad.cz/v1/tax/vat-status/review \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status/review', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-status/review",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

PUT `/v1/tax/vat-status/seat`

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

Nástroj MCP: `set-vat-seat-abroad`

### Tělo požadavku

`seatAbroad` boolean povinné

### Odpověď · 200

`vatPayer` boolean povinné

`vatPeriod` string povinné

`dic` null | string povinné

`history` object\[\] povinné

`from` null | string povinné date

`vatPayer` boolean povinné

`vatPeriod` string povinné

`note` null | string povinné

`payerSince` null | string povinné date

`seatAbroad` boolean povinné

`identifiedFrom` null | string povinné date

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/vat-status/seat \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "seatAbroad": false
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-status/seat', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "seatAbroad": false
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/vat-status/seat",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "seatAbroad": False
    },
)
data = response.json()
```

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

GET `/v1/tax/vat-turnover`

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

Nástroj MCP: `get-vat-turnover`

### Parametry dotazu

`year` integer min 2000 max 2100

### Odpověď · 200

`year` integer povinné

`turnoverHaler` integer povinné

`limitHaler` integer povinné

`fastLimitHaler` integer povinné

`remainingHaler` integer | null povinné

`percent` integer | null povinné

`status` string povinné

`annualExceededOn` null | string povinné date

`fastExceededOn` any povinné

Null in every recorded response.

`previousYearHaler` any povinné

Null in every recorded response.

`duty` null | object povinné

`rule` string povinné

`payerFrom` string povinné date

`applicationDue` string povinné date

`earlierFrom` string date

`seatAbroad` boolean

`mayDeregister` boolean povinné

`months` object\[\] povinné

`month` integer | null povinné

`amountHaler` integer | null povinné

`cumulativeHaler` integer povinné

`vatPayer` boolean povinné

`bySource` object povinné

`invoice` integer

`credit_note` integer

`journal` integer

`adjustment` integer

`adjustments` object\[\] povinné

`object` "vat\_turnover\_adjustment" povinné

`id` string povinné

`date` string povinné date

`amountHaler` integer | null povinné

`note` null | string povinné

`seatAbroad` boolean

`inGroup` boolean

```bash
curl https://api.damedoklad.cz/v1/tax/vat-turnover \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-turnover', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat-turnover",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/vat-turnover/adjustments`

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

Nástroj MCP: `create-vat-turnover-adjustment`

### Tělo požadavku

`date` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`amountHaler` integer povinné min -9007199254740991 max 9007199254740991

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

`note` string povinné max 240 chars

### Odpověď · 201

`id` string povinné

`date` string povinné date

`amountHaler` integer | null povinné

`note` null | string povinné

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "amountHaler": 1210000,
    "note": "string"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "amountHaler": 1210000,
        "note": "string"
    },
)
data = response.json()
```

## Remove a turnover adjustment

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

Remove a turnover adjustment

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

Nástroj MCP: `delete-vat-turnover-adjustment`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`date` string povinné date

`amountHaler` integer | null povinné

`note` null | string povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat-turnover/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat/adjustments`

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

Nástroj MCP: `list-tax-vat-adjustments`

### Parametry dotazu

`year` integer min 2016 max 2100

`month` integer min 1 max 12

`quarter` integer min 1 max 4

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "tax\_vat\_adjustment" povinné

`id` string povinné

`kind` string povinné

`reportDate` string povinné date

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`valueHaler` integer | null povinné

`reducedDeduction` boolean povinné

`inputs` object povinné

`carLimit` boolean

`years` integer

`inputVatHaler` integer

`currentPercent` integer

`originalPercent` integer

`carAcquiredOn` string date

`note` null | string povinné

`effect` object povinné

`row` integer povinné

`values` object povinné

`full` integer

`base` integer

`deductible` integer

`value` integer

`createdAt` string povinné date-time

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/vat/adjustments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/adjustments', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat/adjustments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/vat/adjustments`

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

Nástroj MCP: `create-tax-vat-adjustment`

### Tělo požadavku

`kind` "s75\_correction" | "s77\_settlement" | "s77a\_car" | "s79\_registration" | "s4\_long\_term\_asset" | "s76\_excluded\_taxable" | "s76\_excluded\_exempt" | "s78\_adjustment" | "s78\_oneoff" | "s84\_refund" povinné

`reportDate` string povinné YYYY-MM-DD

Date as YYYY-MM-DD.

`baseHaler` integer min -9007199254740991 max 9007199254740991

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

`vatHaler` integer min -9007199254740991 max 9007199254740991

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

`valueHaler` integer min -9007199254740991 max 9007199254740991

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

`reducedDeduction` boolean

`inputs` object

`inputVatHaler` integer min -9007199254740991 max 9007199254740991

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

`years` 5 | 10

`originalPercent` number min 0 max 100

`currentPercent` number min 0 max 100

`carLimit` boolean

`carPriorVatHaler` integer min -9007199254740991 max 9007199254740991

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

`carAcquiredOn` string YYYY-MM-DD

Date as YYYY-MM-DD.

`note` string max 2000 chars

### Odpověď · 201

`id` string povinné

`kind` string povinné

`reportDate` string povinné date

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`valueHaler` integer | null povinné

`reducedDeduction` boolean povinné

`inputs` object povinné

`carLimit` boolean

`years` integer

`inputVatHaler` integer

`currentPercent` integer

`originalPercent` integer

`carAcquiredOn` string date

`note` null | string povinné

`effect` object povinné

`row` integer povinné

`values` object povinné

`full` integer

`base` integer

`deductible` integer

`value` integer

`createdAt` string povinné date-time

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/vat/adjustments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "s75_correction",
  "reportDate": "2026-10-30"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/adjustments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "s75_correction",
    "reportDate": "2026-10-30"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vat/adjustments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "s75_correction",
        "reportDate": "2026-10-30"
    },
)
data = response.json()
```

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

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

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

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

Nástroj MCP: `delete-tax-vat-adjustment`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat/adjustments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `get-vat-document-detail`

### Parametry v cestě

`type` string povinné

`id` string povinné

### Odpověď · 200

`id` string povinné

`documentType` null | string povinné

`number` null | string povinné

`vatMode` string

`status` string povinné

`taxPointDate` null | string date

`contactName` null | string

`contactDic` null | string

`totalHaler` integer | null

`currency` null | string

`exchangeRate` integer | null povinné

`defaultTreatment` string povinné

`classification` null | object povinné

`treatment` string | null

`deduction` null | string

`deductionPercent` integer | null

`selfAssessRate` integer | null

`reverseChargeCode` string | null

`specialRegime` integer

`reportDate` string | null

`evidenceNumber` string | null

`partnerDic` string | null

`partnerCountry` string | null

`ossCountry` string | null

`ossRate` string | null

`ossRateType` string | null

`ossSupplyType` string | null

`ossScheme` string | null

`carLimit` boolean

`carPriorVatHaler` integer | null

`coefficientExcluded` boolean

`note` string | null

`carInUseOn` string | null

`entries` object\[\] povinné

`documentId` null | string povinné

`documentType` null | string povinné

`number` null | string povinné

`evidenceNumber` null | string povinné

`contactName` null | string povinné

`contactDic` null | string povinné

`contactCountry` string povinné

`date` string povinné date

`taxPointDate` null | string povinné date

`treatment` null | string povinné

`isDefaultTreatment` boolean povinné

`rate` integer povinné

`band` string povinné

`column` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`deductibleVatHaler` integer povinné

`carLimited` boolean povinné

`coefficientExcluded` boolean povinné

`deduction` null | string povinné

`deductionPercent` integer | null povinné

`reverseChargeCode` string | null povinné

`specialRegime` integer povinné

`documentTotalHaler` integer povinné

`isBadDebt` boolean povinné

`khGroupId` any povinné

Null in every recorded response.

`isDebtorCorrection` boolean povinné

`offLedger` boolean povinné

`isCorrection` boolean povinné

`ossCountry` null | string povinné

`ossRate` string | null povinné

`ossRateType` string | null povinné

`ossSupplyType` string | null povinné

`ossScheme` string | null povinné

`currency` null | string povinné

`documentNetHaler` integer povinné

`returnRows` object povinné

`rowLabels` object povinné

`issues` any\[\] povinné

```bash
curl https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

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

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

Nástroj MCP: `update-vat-classification`

### Parametry v cestě

`type` string povinné

`id` string povinné

### Tělo požadavku

`treatment` "output\_domestic" | "output\_reverse\_92a" | "output\_eu\_goods" | "output\_eu\_transfer" | "output\_triangular" | "output\_eu\_services" | "output\_export" | "output\_new\_vehicle" | "output\_oss" | "output\_other\_deductible" | "output\_gold" | "output\_exempt" | "input\_triangular" | "input\_domestic" | "input\_reverse\_92a" | "input\_eu\_goods" | "input\_eu\_services" | "input\_other\_self\_assessed" | "input\_new\_vehicle" | "input\_import\_self" | "input\_import\_customs" | "none" | null

`deduction` "full" | "proportional" | "coefficient" | "none" | null

`deductionPercent` integer | null

`selfAssessRate` integer | null

`reverseChargeCode` string | null

`specialRegime` integer min 0 max 2

`reportDate` string | null

Date as YYYY-MM-DD.

`evidenceNumber` string | null

`partnerDic` string | null

VAT number (DIČ), for example CZ12345678.

`partnerCountry` string | null

`ossCountry` string | null

`ossRate` number | null

`ossRateType` "Z" | "S" | null

`ossSupplyType` "G" | "S" | null

`ossScheme` "EU" | "NON\_EU" | "IMPORT" | null

`carLimit` boolean

`carPriorVatHaler` integer | null

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

`carInUseOn` string | null

Date as YYYY-MM-DD.

`coefficientExcluded` boolean

`note` string | null

### Odpověď · 200

`documentType` null | string povinné

`documentId` null | string povinné

`treatment` null | string povinné

`deduction` null | string povinné

`deductionPercent` integer | null povinné

`selfAssessRate` integer | null povinné

`reverseChargeCode` null | string povinné

`specialRegime` integer povinné

`reportDate` null | string povinné date

`evidenceNumber` string | null povinné

`partnerDic` null | string povinné

`partnerCountry` string | null povinné

`ossCountry` null | string povinné

`ossRate` integer | null povinné

`ossRateType` null | string povinné

`ossSupplyType` null | string povinné

`ossScheme` null | string povinné

`carLimit` boolean povinné

`carPriorVatHaler` integer | null povinné

`coefficientExcluded` boolean povinné

`note` string | null povinné

`carInUseOn` null | string date

```bash
curl -X PUT https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "treatment": "output_domestic",
  "deduction": "full",
  "deductionPercent": 0
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "treatment": "output_domestic",
    "deduction": "full",
    "deductionPercent": 0
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "treatment": "output_domestic",
        "deduction": "full",
        "deductionPercent": 0
    },
)
data = response.json()
```

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

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

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

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

Nástroj MCP: `reset-vat-classification`

### Parametry v cestě

`type` string povinné

`id` string povinné

### Odpověď · 200

`documentType` null | string povinné

`documentId` null | string povinné

`deleted` boolean povinné

```bash
curl -X DELETE https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classification",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

GET `/v1/tax/vat/register`

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

Nástroj MCP: `get-vat-register`

### Parametry dotazu

`year` integer min 2016 max 2100

`month` integer min 1 max 12

`quarter` integer min 1 max 4

### Odpověď · 200

`period` object povinné

`year` integer povinné

`month` integer | null povinné

`key` string povinné

`from` string povinné date

`to` string povinné date

`data` object\[\] povinné

`object` "tax\_document" povinné

`id` string povinné

`documentType` null | string povinné

`number` null | string povinné

`evidenceNumber` null | string povinné

`contactName` null | string povinné

`contactDic` null | string povinné

`contactCountry` string povinné

`date` string povinné date

`taxPointDate` null | string povinné date

`treatment` null | string povinné

`isDefaultTreatment` boolean povinné

`deduction` null | string povinné

`deductionPercent` integer | null povinné

`reverseChargeCode` null | string povinné

`khSection` null | string povinné

`isAdvance` boolean povinné

`isBadDebt` boolean povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`rates` object\[\] povinné

`rate` integer povinné

`baseHaler` integer | null povinné

`vatHaler` integer | null povinné

`flags` object\[\] povinné

`code` null | string povinné

`message` null | string povinné

`note` string | null povinné

`total` integer povinné

`hasMore` boolean povinné

`reconciliation` null | object povinné

`expectedOutputHaler` integer povinné

`expectedInputHaler` integer povinné

`journalOutputHaler` integer povinné

`journalInputHaler` integer povinné

`offLedgerVatHaler` integer povinné

`nonDeductibleHaler` integer povinné

`outputDifferenceHaler` integer povinné

`inputDifferenceHaler` integer povinné

`balanced` boolean povinné

`differences` object\[\] povinné

`documentId` null | string povinné

`documentType` null | string povinné

`isDebtorCorrection` boolean povinné

`number` null | string povinné

`documentVatHaler` integer povinné

`journalVatHaler` integer povinné

`unmatched` object\[\] povinné

`debitHaler` integer povinné

`creditHaler` integer povinné

`accountNumber` null | string povinné

`sourceOid` string povinné

`sourceType` null | string povinné

`sourceEvent` null | string povinné

`sourceLineOid` any povinné

Null in every recorded response.

`number` integer | null povinné

`documentNumber` null | string povinné

`entryDate` string povinné date

```bash
curl https://api.damedoklad.cz/v1/tax/vat/register \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vat/register', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vat/register",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

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

POST `/v1/tax/vat/vies-check`

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

Nástroj MCP: `check-vies-number`

### Tělo požadavku

`vatId` string povinné min 4 chars max 16 chars

ID of the vat.

### Odpověď · 200

`source` string povinné

`checkedAt` null | string date-time

`vatNumber` string povinné

`valid` boolean povinné

`name` null | string

`address` null | string

`wellFormed` boolean

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/vat/vies-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vatId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vat/vies-check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "vatId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()
```

## List TaxVehicles

GET `/v1/tax/vehicles`

List TaxVehicles

Nástroj MCP: `list-tax-vehicles`

### Parametry dotazu

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

`from` string YYYY-MM-DD

Date as YYYY-MM-DD.

`to` string YYYY-MM-DD

Date as YYYY-MM-DD.

### Odpověď · 200

`data` any\[\] povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

```bash
curl https://api.damedoklad.cz/v1/tax/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vehicles', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/tax/vehicles",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## Create a TaxVehicle

POST `/v1/tax/vehicles`

Create a TaxVehicle

Nástroj MCP: `create-tax-vehicle`

### Tělo požadavku

`plate` string povinné max 12 chars

`name` string | null

`category` "M1" | "M2" | "M3" | "N1" | "N2" | "N3" | "O1" | "O2" | "O3" | "O4" povinné

`bodyCode` string | null

`axles` integer | null

`weightTons` number povinné max 999

`airSuspension` boolean

`specialPurpose` boolean

`specialPlate` boolean

`outOfService` boolean

`taxedFrom` string | null

Date as YYYY-MM-DD.

`taxedTo` string | null

Date as YYYY-MM-DD.

`exemptLetter` string | null

`monthsExempt` integer min 0 max 12

`discountPercent` 0 | 25 | 50 | 75 | 90 | 100

### Odpověď · 201

`id` string povinné

`plate` string povinné

`name` null | string povinné

`category` string povinné

`bodyCode` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`airSuspension` boolean povinné

`specialPurpose` boolean povinné

`specialPlate` boolean povinné

`outOfService` boolean povinné

`taxedFrom` null | string povinné date

`taxedTo` string | null povinné

`exemptLetter` string | null povinné

`monthsExempt` integer povinné

`discountPercent` integer povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/tax/vehicles \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plate": "string",
  "category": "M1",
  "weightTons": 1
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/tax/vehicles",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "plate": "string",
        "category": "M1",
        "weightTons": 1
    },
)
data = response.json()
```

## Update a TaxVehicle

PATCH `/v1/tax/vehicles/{id}`

Update a TaxVehicle

Nástroj MCP: `update-tax-vehicle`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`plate` string max 12 chars

`name` string | null

`category` "M1" | "M2" | "M3" | "N1" | "N2" | "N3" | "O1" | "O2" | "O3" | "O4"

`bodyCode` string | null

`axles` integer | null

`weightTons` number max 999

`airSuspension` boolean

`specialPurpose` boolean

`specialPlate` boolean

`outOfService` boolean

`taxedFrom` string | null

Date as YYYY-MM-DD.

`taxedTo` string | null

Date as YYYY-MM-DD.

`exemptLetter` string | null

`monthsExempt` integer min 0 max 12

`discountPercent` 0 | 25 | 50 | 75 | 90 | 100

### Odpověď · 200

`id` string povinné

`plate` string povinné

`name` null | string povinné

`category` string povinné

`bodyCode` null | string povinné

`axles` integer | null povinné

`weightTons` integer povinné

`airSuspension` boolean povinné

`specialPurpose` boolean povinné

`specialPlate` boolean povinné

`outOfService` boolean povinné

`taxedFrom` null | string povinné date

`taxedTo` string | null povinné

`exemptLetter` string | null povinné

`monthsExempt` integer povinné

`discountPercent` integer povinné

```bash
curl -X PATCH https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plate": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "category": "M1"
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "plate": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "category": "M1"
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "plate": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "category": "M1"
    },
)
data = response.json()
```

## Delete a TaxVehicle

DELETE `/v1/tax/vehicles/{id}`

Delete a TaxVehicle

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

Nástroj MCP: `delete-tax-vehicle`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();
```

```python
import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/tax/vehicles/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```