Skip to main content
GET
curl

Authorizations

x-api-key
string
header
required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

connectionId
string<uuid>
required

UUID der DATEV-Verbindung. Abrufbar über den /connections-Endpunkt des jeweiligen Moduls (z. B. GET /v2/datev-duo/connections).

Example:

"abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145"

companyId
string

Mandanten-ID im Format <Beraternummer>-<Mandantennummer>. Nur nötig wenn die Connection mehrere Mandanten umfasst (Steuerberater-Account) und nicht der Default-Mandant gemeint ist. Ohne diesen Parameter nutzt DATEV den beim OAuth gewählten Default-Mandanten — der hat aber je nach Setup keine Export-Subscription, dann kommt 403 zurück.

Example:

"386587-29183"

geschaeftsjahrStartDatum
string<date>
required

Startdatum des Geschäftsjahrs (YYYY-MM-DD).

quelle
string
default:API

Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: API (direkter API-Aufruf). Für Automationen aus Make z. B. Make angeben.

Example:

"Make"

Response

Kontenplan: Liste der Sach- und Personenkonten

data
object[]
meta
object

Metadaten der DATEV-Schnittstelle (z.B. Pagination-Hinweise), nur wenn geliefert.

business-os
object