Skip to main content
GET
/
v2
/
datev-rewe-read
/
permissions
RVO-Rechte-Probe
curl --request GET \
  --url https://api.business-os.de/v2/datev-rewe-read/permissions \
  --header 'x-api-key: <api-key>'
{
  "subscription": "ok",
  "fiscalYearStartDate": "2026-01-01",
  "yearsCount": 2,
  "checks": {
    "stammdaten": {
      "status": "ok",
      "httpStatus": 200
    },
    "auswertungen": {
      "status": "ok",
      "httpStatus": 200
    },
    "kontobuchungen": {
      "status": "permission",
      "httpStatus": 403,
      "message": "Access to the requested resource is forbidden."
    },
    "opos": {
      "status": "ok",
      "httpStatus": 200
    }
  },
  "tool": "DATEV Rechnungswesen - Read",
  "probedAt": "2026-05-30T09:24:46.125Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.business-os.de/llms.txt

Use this file to discover all available pages before exploring further.

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"

Response

Probe-Ergebnis pro RVO-Teilrecht

​
subscription
enum<string>
required

Aggregierter Status über alle 4 Teilrechte hinweg. ok wenn mindestens eines ok ist; missing wenn alle 4 mit 403 antworten (Service-/RVO-Recht fehlt komplett); expired wenn mindestens eines mit 401 antwortet (Token abgelaufen); sonst unknown.

Available options:
ok,
missing,
expired,
unknown
​
checks
object
required

Pro RVO-Teilrecht ein Check-Eintrag.

​
tool
string
required
Example:

"DATEV Rechnungswesen - Read"

​
probedAt
string<date-time>
required

Zeitstempel der Probe (ISO 8601).

​
fiscalYearStartDate
string<date> | null

Aus der Stammdaten-Probe (/accounting/fiscalYears) abgeleitetes Start-Datum des jüngsten Geschäftsjahres — wird intern für die anderen 3 Probes als Query-Parameter benötigt. null wenn Stammdaten-Probe nicht 200 zurückgegeben hat.

Example:

"2026-01-01"

​
yearsCount
integer | null

Anzahl Geschäftsjahre, die der Mandant in DATEV hat. null wenn Stammdaten-Probe nicht 200 zurückgegeben hat.

Example:

2