Number series

Operations in the Number series group.

Base URLhttps://api.damedoklad.cz/v1Authentication Errors and limits Conventions

GET/v1/series
POST/v1/series
GET/v1/series/{id}
PATCH/v1/series/{id}
DEL/v1/series/{id}
GET/v1/series/{id}/gaps

List number series. Every issued document takes its number from one, per accounting period

GET/v1/series

List number series. Every issued document takes its number from one, per accounting period

MCP tool: list-series

Query parameters

periodIdstring

Only series of this accounting period.

documentTypestring

For example invoice, proforma, credit_note, delivery_note, received_invoice.

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Response · 200

dataobject[]required

object"series"required

idstringrequired

namestringrequired

documentTypestringrequired

prefixstringrequired

includeYearstringrequired

padintegerrequired

nextNumberintegerrequired

periodIdstringrequired

periodNamestringrequired

isDefaultbooleanrequired

isSystembooleanrequired

isActivebooleanrequired

previewstringrequired

totalinteger

Rows that match, on all pages.

hasMorebooleanrequired

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

GET/v1/series

curl https://api.damedoklad.cz/v1/series \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Create a number series for a document type and accounting period

POST/v1/series

Create a number series for a document type and accounting period

MCP tool: create-series

Request body

namestringmax 80 chars

prefixstringrequiredmax 8 chars

includeYear"yyyy" | "yy" | "none"

padintegermin 3max 6

nextNumberintegermin 1max 999999

periodIdstring

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

isDefaultboolean

isActiveboolean

Response · 201

idstringrequired

namestringrequired

documentTypestringrequired

prefixstringrequired

includeYearstringrequired

padintegerrequired

nextNumberintegerrequired

periodIdstringrequired

periodNamestringrequired

isDefaultbooleanrequired

isSystembooleanrequired

isActivebooleanrequired

previewstringrequired

POST/v1/series

curl -X POST https://api.damedoklad.cz/v1/series \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "issued_invoice",
  "prefix": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/series",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "issued_invoice",
        "prefix": "string"
    },
)
data = response.json()

Get a number series, with a preview of the next number

GET/v1/series/{id}

Get a number series, with a preview of the next number

MCP tool: get-series

Path parameters

idstringrequired

Response · 200

idstringrequired

namestringrequired

documentTypestringrequired

prefixstringrequired

includeYearstringrequired

padintegerrequired

nextNumberintegerrequired

periodIdstringrequired

periodNamestringrequired

isDefaultbooleanrequired

isSystembooleanrequired

isActivebooleanrequired

previewstringrequired

GET/v1/series/{id}

curl https://api.damedoklad.cz/v1/series/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Update a number series. Numbers already issued do not change

PATCH/v1/series/{id}

Update a number series. Numbers already issued do not change

MCP tool: update-series

Path parameters

idstringrequired

Request body

namestringmax 80 chars

prefixstringmax 8 chars

includeYear"yyyy" | "yy" | "none"

padintegermin 3max 6

nextNumberintegermin 1max 999999

isDefaultboolean

isActiveboolean

Response · 200

idstringrequired

namestringrequired

documentTypestringrequired

prefixstringrequired

includeYearstringrequired

padintegerrequired

nextNumberintegerrequired

periodIdstringrequired

periodNamestringrequired

isDefaultbooleanrequired

isSystembooleanrequired

isActivebooleanrequired

previewstringrequired

PATCH/v1/series/{id}

curl -X PATCH https://api.damedoklad.cz/v1/series/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "prefix": "string",
  "includeYear": "yyyy"
}'

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

import os
import requests

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

Delete a number series that has not issued any number

DELETE/v1/series/{id}

Delete a number series that has not issued any number

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

MCP tool: delete-series

Path parameters

idstringrequired

Response · 200

idstringrequired

deletedbooleanrequired

DELETE/v1/series/{id}

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

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

import os
import requests

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

Find gaps in the numbers a series has issued. Tax documents should run without gaps

GET/v1/series/{id}/gaps

Find gaps in the numbers a series has issued. Tax documents should run without gaps

MCP tool: get-series-gaps

Path parameters

idstringrequired

Response · 200

idstringrequired

fromintegerrequired

tointegerrequired

missinginteger[]required

usedinteger[]required

GET/v1/series/{id}/gaps

curl https://api.damedoklad.cz/v1/series/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gaps \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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