Mandanten und aktive Services

Listet alle Mandanten (Companies), die unter der angegebenen DATEV-Verbindung verfügbar sind, samt der je Mandant aktiven Service-Subscriptions (z. B. Belegbilderservice, Rechnungsdatenservice 1.0, DATEV Rechnungswesen-Exportservice).

Kosten: 1 Credit pro Aufruf

GET /v2/datev/companies

Mandanten und aktive DATEV-Services

cURL

curl --request GET \
  --url https://api.business-os.de/v2/datev/companies \
  --header 'x-api-key: <api-key>'

200

Example

{
  "data": [
    {
      "subscription": [
        {
          "id": null,
          "name": "Belegbilderservice",
          "status": null,
          "active": true
        },
        {
          "id": null,
          "name": "Rechnungsdatenservice 1.0",
          "status": null,
          "active": true
        }
      ],
      "id": "122130-13170",
      "client_number": 13170,
      "consultant_number": 122130,
      "environmentId": null,
      "name": "Mustermann GmbH"
    }
  ]
}

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"

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

200

application/json

Liste der Mandanten und deren Service-Subscriptions

data · object[]

Show child attributes