Accounting

Endpointhttps://api.kontorion.eu/v1

Accounting integrations and export artifacts (DATEV and other providers).

List exports available across all enabled providers

GET

https://api.kontorion.eu/v1

/accounting/exports/catalog

Lists the export kinds offered by providers whose integration is enabled — each entry is a provider/kind pair accepted by GET /accounting/exports/{provider}/{kind}. Providers without an enabled integration contribute no entries.

List exports available across all enabled providers › Headers

X-Workspace-Id

string

Selects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.

Workspace UUID or slug.

List exports available across all enabled providers › Responses

array | null · required

GET/accounting/exports/catalog

curl --request GET \
  --url https://api.kontorion.eu/v1/accounting/exports/catalog

shell

Example Responses

{
  "data": [
    {
      "display_name": "display_name",
      "export": {
        "description": "description",
        "extension": "extension",
        "kind": "kind",
        "label": "label",
        "mime_type": "mime_type",
        "options": [
          {
            "default": {},
            "group": "group",
            "help": "help",
            "key": "key",
            "label": "label",
            "options": [
              {
                "label": "label",
                "value": "value"
              }
            ],
            "placeholder": "placeholder",
            "required": true,
            "type": "type"
          }
        ]
      },
      "provider": "provider"
    }
  ]
}

json

application/json

List recent export runs for the caller's organization

GET

https://api.kontorion.eu/v1

/accounting/exports/history

Returns the most recent recorded export runs (audit records), newest first. limit caps the row count (default 50); the list is not cursor-paginated.

List recent export runs for the caller's organization › query Parameters

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

List recent export runs for the caller's organization › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List recent export runs for the caller's organization › Responses

array | null · required

object · required

GET/accounting/exports/history

curl --request GET \
  --url https://api.kontorion.eu/v1/accounting/exports/history

shell

Example Responses

{
  "data": [
    {
      "created_at": "2024-08-25T15:00:00Z",
      "file_sha256": "file_sha256",
      "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "invoice_count": 0,
      "kind": "kind",
      "line_count": 0,
      "organization_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "period_from": "2024-08-25T15:00:00Z",
      "period_to": "2024-08-25T15:00:00Z",
      "provider": "provider",
      "summary_json": {},
      "user_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
    }
  ],
  "pagination": {
    "counts": {
      "key": {
        "key": 0
      }
    },
    "cursor": "cursor",
    "has_more": true,
    "total_count": 0
  }
}

json

application/json

Stream an export artifact

GET

https://api.kontorion.eu/v1

/accounting/exports/{provider}/{kind}

Streams the export file (CSV or ZIP depending on the export kind). The X-Accounting-Summary response header carries a base64-encoded JSON summary; X-Export-Sha256 fingerprints the payload; X-Audit-Id references the recorded export run.

Stream an export artifact › path Parameters

provider

string · required

Provider id

kind

string · enum · required

Export kind

Enum values:

bookings

master_data

invoices_pdf

Stream an export artifact › query Parameters

from

string

Period start (YYYY-MM-DD) - required for bookings + invoices_pdf

to

string

Period end (YYYY-MM-DD) - required for bookings + invoices_pdf

posting_mode

string · enum

Override the stored posting mode for this export

Enum values:

postpaid

prepaid_without_debtor

auto

amount_basis

string · enum

Override the stored amount basis for this export

Enum values:

gross

net

grouping

string · enum

Override the stored grouping for this export

Enum values:

per_invoice

per_item

only_billable

string

Filter master_data to billable customers (true/1)

Stream an export artifact › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Stream an export artifact › Responses

Export artifact

No data returned

List accounting integrations

GET

https://api.kontorion.eu/v1

/accounting/integrations

Returns every configured accounting provider for the caller's organization.

List accounting integrations › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List accounting integrations › Responses

array | null · required

GET/accounting/integrations

curl --request GET \
  --url https://api.kontorion.eu/v1/accounting/integrations

shell

Example Responses

{
  "data": [
    {
      "config": {
        "config": {},
        "created_at": "2024-08-25T15:00:00Z",
        "display_name": "display_name",
        "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "is_enabled": true,
        "organization_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "provider": "provider",
        "updated_at": "2024-08-25T15:00:00Z"
      },
      "display_name": "display_name",
      "exports": [
        {
          "description": "description",
          "extension": "extension",
          "kind": "kind",
          "label": "label",
          "mime_type": "mime_type",
          "options": [
            {
              "default": {},
              "group": "group",
              "help": "help",
              "key": "key",
              "label": "label",
              "options": [
                {
                  "label": "label",
                  "value": "value"
                }
              ],
              "placeholder": "placeholder",
              "required": true,
              "type": "type"
            }
          ]
        }
      ],
      "provider": "provider",
      "schema": {
        "fields": [
          {
            "default": {},
            "group": "group",
            "help": "help",
            "key": "key",
            "label": "label",
            "options": [
              {
                "label": "label",
                "value": "value"
              }
            ],
            "placeholder": "placeholder",
            "required": true,
            "type": "type"
          }
        ]
      }
    }
  ]
}

json

application/json

Get a single accounting integration's config

GET

https://api.kontorion.eu/v1

/accounting/integrations/{provider}/settings

Returns the stored settings row for one registered provider. A provider that is registered but not yet configured responds 200 with an empty config shell (the first PATCH creates the row); unregistered provider ids respond 404.

Get a single accounting integration's config › path Parameters

provider

string · required

Provider id (e.g. datev)

Get a single accounting integration's config › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a single accounting integration's config › Responses

object · required

Create or update an accounting integration's config

PATCH

https://api.kontorion.eu/v1

/accounting/integrations/{provider}/settings

Creates the provider's settings row on first save and updates it afterwards. The config object is validated and normalized by the provider (defaults filled in) before persisting. Requires the accounting.manage or org.update permission.

Create or update an accounting integration's config › path Parameters

provider

string · required

Provider id (e.g. datev)

Create or update an accounting integration's config › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Create or update an accounting integration's config › Request Body

config

Provider-specific configuration, validated against the provider's settings schema before it is stored.

display_name

string · maxLength: 200

Human-readable name; omitted defaults to the provider's own display name.

is_enabled

boolean

Whether the integration is active and exports may run against it.

Create or update an accounting integration's config › Responses

object · required

PATCH/accounting/integrations/{provider}/settings

curl --request PATCH \
  --url https://api.kontorion.eu/v1/accounting/integrations/:provider/settings \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {},
  "display_name": "display_name",
  "is_enabled": true
}
'

shell

Example Request Body

{
  "config": {},
  "display_name": "display_name",
  "is_enabled": true
}

json

Example Responses

{
  "data": {
    "config": {},
    "created_at": "2024-08-25T15:00:00Z",
    "display_name": "display_name",
    "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "is_enabled": true,
    "organization_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
    "provider": "provider",
    "updated_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Tags Analytics

List exports available across all enabled providers

GET

https://api.kontorion.eu/v1

/accounting/exports/catalog

List exports available across all enabled providers › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List exports available across all enabled providers › Responses

array | null · required

List recent export runs for the caller's organization

GET

https://api.kontorion.eu/v1

/accounting/exports/history

Returns the most recent recorded export runs (audit records), newest first. limit caps the row count (default 50); the list is not cursor-paginated.

List recent export runs for the caller's organization › query Parameters

limit

integer · min: 1

Page size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.

Example: 50

List recent export runs for the caller's organization › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List recent export runs for the caller's organization › Responses

array | null · required

object · required

Stream an export artifact

GET

https://api.kontorion.eu/v1

/accounting/exports/{provider}/{kind}

Stream an export artifact › path Parameters

provider

string · required

Provider id

kind

string · enum · required

Export kind

Enum values:

bookings

master_data

invoices_pdf

Stream an export artifact › query Parameters

from

string

Period start (YYYY-MM-DD) - required for bookings + invoices_pdf

to

string

Period end (YYYY-MM-DD) - required for bookings + invoices_pdf

posting_mode

string · enum

Override the stored posting mode for this export

Enum values:

postpaid

prepaid_without_debtor

auto

amount_basis

string · enum

Override the stored amount basis for this export

Enum values:

gross

net

grouping

string · enum

Override the stored grouping for this export

Enum values:

per_invoice

per_item

only_billable

string

Filter master_data to billable customers (true/1)

Stream an export artifact › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Stream an export artifact › Responses

Export artifact

No data returned

List accounting integrations

GET

https://api.kontorion.eu/v1

/accounting/integrations

Returns every configured accounting provider for the caller's organization.

List accounting integrations › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List accounting integrations › Responses

array | null · required

Get a single accounting integration's config

GET

https://api.kontorion.eu/v1

/accounting/integrations/{provider}/settings

Get a single accounting integration's config › path Parameters

provider

string · required

Provider id (e.g. datev)

Get a single accounting integration's config › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a single accounting integration's config › Responses

object · required

Create or update an accounting integration's config

PATCH

https://api.kontorion.eu/v1

/accounting/integrations/{provider}/settings

Create or update an accounting integration's config › path Parameters

provider

string · required

Provider id (e.g. datev)

Create or update an accounting integration's config › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Create or update an accounting integration's config › Request Body

config

Provider-specific configuration, validated against the provider's settings schema before it is stored.

display_name

string · maxLength: 200

Human-readable name; omitted defaults to the provider's own display name.

is_enabled

boolean

Whether the integration is active and exports may run against it.

Create or update an accounting integration's config › Responses

object · required