Usage-Export-API

Usage-Export-API: Verbrauchsdaten für die Buchhaltung

Mit der Usage-Export-API holen Sie Ihre Abrechnungs- und Verbrauchsdaten maschinenlesbar ab, ideal für Buchhaltung, Controlling oder das automatische Verbuchen der monatlichen KI-Kosten in Ihrem Finanzsystem. Ein einziger Endpoint liefert pro Account und Monat alle Kostenbausteine als JSON.

Wozu dient der Export?

Monatliche Kosten (Grundgebühr, Speicher, SLA, KI- und Tool-Verbrauch) automatisiert in Buchhaltungs- oder BI-Systeme übernehmen.
Interne Leistungsverrechnung: Kosten je Account (z. B. je Tochtergesellschaft oder Fachbereich) auswerten.
Historische Verbrauchsdaten für Forecasts und Budgetplanung abrufen.

Die Werte entsprechen der Kostenaufstellung auf der Verbrauchsseite in der App, siehe Abrechnung.

Authentifizierung

Die Usage-Export-API nutzt einen dedizierten API-Token, unabhängig vom Account-API-Key der Integrations-API:

Format: api_token_ gefolgt von 64 Hex-Zeichen, übergeben im Header X-API-Key.
Scopes: account (Zugriff auf einen einzelnen Account) oder all_accounts (übergreifender Zugriff, z. B. für Konzern-Reporting).
Gültigkeit: standardmäßig 1 Jahr ab Erstellung, danach muss der Token erneuert werden.
Rate-Limit: pro Token, standardmäßig 1000 Anfragen pro Stunde.

Die Tokens werden von uns erstellt und verwaltet. Fordern Sie Ihren Token beim Support an: hello@hermine.ai (bitte gewünschten Scope angeben).

Endpunkt

GET https://app.hermine.ai/api/v1/usage_exports

Parameter	Beschreibung
`from_date`	Beginn des Zeitraums im Format `YYYY-MM-DD` (zusammen mit `to_date` verwenden)
`to_date`	Ende des Zeitraums im Format `YYYY-MM-DD`
`months_back`	Alternative zu den Datumsparametern: Anzahl Monate rückwirkend ab heute (1 bis 120)
`account_id`	Auf einen Account filtern, nur für Tokens mit Scope `all_accounts`

Ohne Parameter liefert die API standardmäßig den letzten Monat.

Antwortformat

Die Antwort enthält je Account die Stammdaten und eine Monatsliste mit den Kostenbausteinen:

{
  "data": [
    {
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "account_name": "Acme Corporation",
      "plan_name": "Standard",
      "months": [
        {
          "month": "2026-06",
          "subscription_cost": 400.00,
          "storage_cost": 7.50,
          "sla_cost": 300.00,
          "ai_tools_cost": 125.50,
          "ai_request_count": 3420
        }
      ]
    }
  ],
  "meta": {
    "generated_at": "2026-07-01T10:30:00Z",
    "from_date": "2026-06-01",
    "to_date": "2026-06-30",
    "total_accounts": 1
  }
}

Feld	Bedeutung
`subscription_cost`	Grundgebühr (Benutzer-Lizenzen) des Monats
`storage_cost`	Kosten für gebuchten Zusatzspeicher
`sla_cost`	Kosten des gebuchten Support-Levels (SLA)
`ai_tools_cost`	Summe der nutzungsabhängigen KI- und Tool-Kosten
`ai_request_count`	Anzahl der KI-Anfragen im Monat

Bei Fehlern antwortet die API mit 400 (ungültiges Datumsformat), 401 (ungültiger oder abgelaufener Token) oder 429 (Rate-Limit erreicht), jeweils mit einer error-Meldung im JSON.

Schritt für Schritt einrichten

Token anfordern: Schreiben Sie an hello@hermine.ai und nennen Sie den gewünschten Scope (account oder all_accounts).

Ersten Abruf testen:

curl "https://app.hermine.ai/api/v1/usage_exports?from_date=2026-01-01&to_date=2026-06-30" \
  -H "X-API-Key: api_token_IHR_TOKEN"

Import automatisieren: Rufen Sie den Export z. B. monatlich per Cron ab und übernehmen Sie die Felder in Ihr Zielsystem. Für laufende Abrufe genügt months_back=1.

Referenz

Für die Usage-Export-API existiert eine vollständige OpenAPI-3.0-Spezifikation mit allen Schemas und Beispielen. Sie erhalten sie zusammen mit Ihrem Token vom Support.

Tipp: Legen Sie sich eine Erinnerung vor Ablauf der Token-Gültigkeit an (standardmäßig 1 Jahr). So läuft Ihr automatisierter Buchhaltungs-Import ohne Unterbrechung weiter.

Suche

Menu