curl --request GET \
--url https://api.business-os.de/v2/datev-rewe-read/opos \
--header 'x-api-key: <api-key>'import requests
url = "https://api.business-os.de/v2/datev-rewe-read/opos"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.business-os.de/v2/datev-rewe-read/opos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.business-os.de/v2/datev-rewe-read/opos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.business-os.de/v2/datev-rewe-read/opos"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.business-os.de/v2/datev-rewe-read/opos")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.business-os.de/v2/datev-rewe-read/opos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"stichtag": "2026-12-31",
"konten": [
{
"kontonummer": "100012345",
"bezeichnung": "Mustermann GmbH",
"isDebitor": true,
"totalSaldo": 12450.5,
"posten": [
{
"beleg": "R-2024-003",
"belegdatum": "2024-03-15",
"buchungstext": "Lizenzgebühr Q1 2024",
"saldo": 4500
}
]
}
],
"sumDebitoren": 24500,
"sumKreditoren": -8200
},
"business-os": {
"neuesGuthaben": 123
}
}OPOS — Offene Posten
Aggregiert alle Buchungen aller Geschäftsjahre der Connection und gibt den Stand der offenen Posten pro Personenkonto zurück — gruppiert nach (Personenkonto, Belegnummer), sortiert nach |Saldo| absteigend.
Intern werden Geschäftsjahre + Kontenplan + alle GJ-Buchungen parallel von DATEV gefetched (typisch 15-30s für mittelgroße Mandanten). EBs werden nach DATEV-Konvention (saldo-neutrales SOLL/HABEN-Paar pro Personenkonto) korrekt behandelt; bei Konten mit Vor-Sync-Aktivität erscheint ein EB-RESIDUAL-Posten.
Bekannte Limitation: der Endpoint erfasst nur klassische 9-stellige Personenkonten. Mandanten mit eigenen 8-stelligen Forderungs-/Verbindlichkeits-Sachkonten (z.B. 15970000 Forderungen gg. XYZ) sehen darüber nicht alle ihre OPs — solche Konten sind über die SuSa direkt abrufbar.
Kosten: 5 Credits
curl --request GET \
--url https://api.business-os.de/v2/datev-rewe-read/opos \
--header 'x-api-key: <api-key>'import requests
url = "https://api.business-os.de/v2/datev-rewe-read/opos"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.business-os.de/v2/datev-rewe-read/opos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.business-os.de/v2/datev-rewe-read/opos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.business-os.de/v2/datev-rewe-read/opos"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.business-os.de/v2/datev-rewe-read/opos")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.business-os.de/v2/datev-rewe-read/opos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"stichtag": "2026-12-31",
"konten": [
{
"kontonummer": "100012345",
"bezeichnung": "Mustermann GmbH",
"isDebitor": true,
"totalSaldo": 12450.5,
"posten": [
{
"beleg": "R-2024-003",
"belegdatum": "2024-03-15",
"buchungstext": "Lizenzgebühr Q1 2024",
"saldo": 4500
}
]
}
],
"sumDebitoren": 24500,
"sumKreditoren": -8200
},
"business-os": {
"neuesGuthaben": 123
}
}Authorizations
Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.
Query Parameters
UUID der DATEV-Verbindung. Abrufbar über den /connections-Endpunkt des jeweiligen Moduls (z. B. GET /v2/datev-duo/connections).
"abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145"
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.
"386587-29183"
OP-Stichtag (YYYY-MM-DD). Default: heute. Filter belegdatum <= stichtag.
Optionaler Server-Filter: debitors (nur erste Ziffer 1-6), creditors (7-9), all (default).
all, debitors, creditors Behandlung der Eröffnungsbilanz-Werte. reconcile (default): EBs werden mit Detail-Posten verrechnet; ein Restbetrag erscheint als EB-RESIDUAL-Posten. raw: EBs werden als reguläre Posten unter beleg = '0' ausgegeben (Debug/Wirtschaftsprüfung).
reconcile, raw Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: API (direkter API-Aufruf). Für Automationen aus Make z. B. Make angeben.
"Make"