Skip to content

Abrechnung abrufen (get_billing)

Mit get_billing rufst du deine HiWalter-Abrechnungsdaten ab: deinen aktuellen Plan, den Abo-Status, Anfang und Ende des Abrechnungszeitraums sowie deine verbleibenden Fair-Use-Kontingente.

Nutze diesen Endpunkt, um:

  • deinen aktuellen Plan und Abo-Status zu prüfen,
  • dein nächstes Verlängerungsdatum zu bestätigen,
  • Live-Abrechnungsdaten direkt in deiner eigenen Anwendung anzuzeigen.
POST https://api.hiwalter.de/api/v1/tools/get_billing

Dieser Endpunkt erwartet keine Argumente. Sende ein leeres JSON-Objekt ({}).

Deinen API-Schlüssel übergibst du als Bearer-Token im Authorization-Header. Schlüssel haben das Format hw_XXXXXXXXXXX.

HeaderTypErforderlichBeschreibung
AuthorizationstringjaDein API-Schlüssel als Bearer-Token, z. B. Bearer hw_XXXXXXXXXXX.
Content-Typestringjaapplication/json
Terminal window
curl --request POST \
--url https://api.hiwalter.de/api/v1/tools/get_billing \
--header 'Authorization: Bearer hw_XXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data '{}'

Bei Erfolg liefert der Endpunkt Status 200 und ein Objekt mit deinen Abrechnungsdaten.

{
"results": {
"plan": "subscription_997",
"subscription_status": "active",
"unlimited": true,
"current_period_start": "2026-07-09",
"current_period_end": "2026-08-09"
},
"status": "ok",
"metadata": {
"fair_use": {
"records_remaining_5h": 179999,
"records_reset_5h": "2026-07-15T18:53:16Z",
"records_remaining_1w": 899999,
"records_reset_1w": "2026-07-22T13:53:16Z"
}
}
}
FeldTypBeschreibung
results.planstringKennung deines aktuellen Plans, z. B. subscription_997 (999 € pro Zeitraum).
results.subscription_statusstringStatus deines Abos, z. B. active.
results.unlimitedbooleantrue, wenn dein Plan unbegrenzte Nutzung umfasst (ohne Tokens, ohne Credits).
results.current_period_startstringStartdatum des aktuellen Abrechnungszeitraums (YYYY-MM-DD).
results.current_period_endstringEnddatum des aktuellen Abrechnungszeitraums bzw. dein nächstes Verlängerungsdatum (YYYY-MM-DD).
statusstringGesamtstatus der Antwort, z. B. ok.
metadata.fair_useobjectFair-Use-Kontingente: verbleibende Datensätze und Reset-Zeitpunkte für das 5-Stunden- und das 1-Wochen-Fenster.