# Settings · DameDoklad API

> Operations in the Settings group.

Source: https://damedoklad.cz/en/docs/api-reference/settings/

# Settings

Operations in the Settings group.

## Get the accounting settings of a period: which series each document type uses by default

GET `/v1/settings/accounting`

Get the accounting settings of a period: which series each document type uses by default

MCP tool: `get-accounting-settings`

### Query parameters

`periodId` string

Accounting period. Defaults to the current one.

### Response · 200

`periodId` string required

`periodName` string required

`defaults` object required

`issued_invoice` object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`credit_note` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`proforma` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`delivery_note` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`received_invoice` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/settings/accounting', {
  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/settings/accounting",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()
```

## Replace the accounting settings of a period

PUT `/v1/settings/accounting`

Replace the accounting settings of a period

MCP tool: `put-accounting-settings`

### Request body

`periodId` string

ID of the period. Find it with list-periods.

`defaults` object required

`issued_invoice` string required

`credit_note` string required

`proforma` string required

`delivery_note` string required

`received_invoice` string required

### Response · 200

`periodId` string required

`periodName` string required

`defaults` object required

`issued_invoice` object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`credit_note` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`proforma` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`delivery_note` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

`received_invoice` null | object required

`seriesId` null | string required

`name` null | string required

`prefix` string required

`preview` string required

```bash
curl -X PUT https://api.damedoklad.cz/v1/settings/accounting \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "defaults": {
    "issued_invoice": "string",
    "credit_note": "string",
    "proforma": "string",
    "delivery_note": "string",
    "received_invoice": "string"
  }
}'
```

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/settings/accounting', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "defaults": {
      "issued_invoice": "string",
      "credit_note": "string",
      "proforma": "string",
      "delivery_note": "string",
      "received_invoice": "string"
    }
  }),
});
const data = await response.json();
```

```python
import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/settings/accounting",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "defaults": {
            "issued_invoice": "string",
            "credit_note": "string",
            "proforma": "string",
            "delivery_note": "string",
            "received_invoice": "string"
        }
    },
)
data = response.json()
```