Konto abrufen (get_account)

Ruft die Details deines Hi Walter Kontos ab: Kontoname, aktueller Plan, Kontostatus, verbleibendes Guthaben, Anzahl der API-Keys und Nutzerzahl. Dieser Endpunkt ist kostenlos und verbraucht keine Credits.

Nutze diesen Endpunkt, um:

• den Kontozustand programmatisch zu prüfen
• zu bestätigen, dass dein Konto aktiv ist
• Kontoinformationen in deiner eigenen Anwendung oder deinem Dashboard anzuzeigen

POST https://api.hiwalter.de/api/v1/tools/get_account

Anfrage

Es sind keine Argumente erforderlich. Sende ein leeres Objekt.

Übergib deinen API-Key als Bearer-Token. Keys haben das Format hw_XXXXXXXXXXX.

Beispiel

curl -X POST https://api.hiwalter.de/api/v1/tools/get_account \
  -H "Authorization: Bearer DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Antwort

{
  "results": {
    "id": "kZ9pQ2rt",
    "name": "BrightHollow",
    "status": "active",
    "plan": "subscription_97",
    "token_balance": -1,
    "unlimited": true,
    "fair_use": {
      "enrich": {
        "records": {
          "5h": { "limit": 15000, "used": 0, "remaining": 15000, "resets_at": null },
          "1w": { "limit": 75000, "used": 0, "remaining": 75000, "resets_at": null }
        },
        "requests": {
          "5h": { "limit": 75000, "used": 0, "remaining": 75000, "resets_at": null }
        }
      },
      "search": {
        "records": {
          "5h": { "limit": 7500, "used": 0, "remaining": 7500, "resets_at": null },
          "1w": { "limit": 37500, "used": 0, "remaining": 37500, "resets_at": null }
        },
        "requests": {
          "5h": { "limit": 37500, "used": 0, "remaining": 37500, "resets_at": null }
        }
      }
    },
    "api_key_count": 1,
    "user_count": 1,
    "created_at": "2026-06-12T16:11:41Z"
  },
  "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.id	string	Eindeutige Konto-ID
results.name	string	Kontoname
results.status	string	Kontostatus, z. B. active
results.plan	string	Aktueller Plan
results.token_balance	number	Verbleibendes Guthaben; -1 bei unbegrenztem Kontingent
results.unlimited	boolean	Gibt an, ob das Konto ein unbegrenztes Kontingent hat
results.fair_use	object	Fair-Use-Limits pro Kategorie (enrich, search) mit records und requests je Zeitfenster (5h, 1w)
results.api_key_count	number	Anzahl der aktiven API-Keys
results.user_count	number	Anzahl der Nutzer im Konto
results.created_at	string	Erstellungszeitpunkt des Kontos (ISO 8601)
status	string	Status der Antwort, z. B. ok
metadata.fair_use	object	Verbleibende Fair-Use-Kontingente und deren Reset-Zeitpunkte