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_billingAnfrage
Section titled “Anfrage”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.
| Header | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
Authorization | string | ja | Dein API-Schlüssel als Bearer-Token, z. B. Bearer hw_XXXXXXXXXXX. |
Content-Type | string | ja | application/json |
Beispiel (curl)
Section titled “Beispiel (curl)”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/get_billing \ --header 'Authorization: Bearer hw_XXXXXXXXXXX' \ --header 'Content-Type: application/json' \ --data '{}'Antwort
Section titled “Antwort”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" } }}| Feld | Typ | Beschreibung |
|---|---|---|
results.plan | string | Kennung deines aktuellen Plans, z. B. subscription_997 (999 € pro Zeitraum). |
results.subscription_status | string | Status deines Abos, z. B. active. |
results.unlimited | boolean | true, wenn dein Plan unbegrenzte Nutzung umfasst (ohne Tokens, ohne Credits). |
results.current_period_start | string | Startdatum des aktuellen Abrechnungszeitraums (YYYY-MM-DD). |
results.current_period_end | string | Enddatum des aktuellen Abrechnungszeitraums bzw. dein nächstes Verlängerungsdatum (YYYY-MM-DD). |
status | string | Gesamtstatus der Antwort, z. B. ok. |
metadata.fair_use | object | Fair-Use-Kontingente: verbleibende Datensätze und Reset-Zeitpunkte für das 5-Stunden- und das 1-Wochen-Fenster. |