Zum Hauptinhalt springen

Übersicht

Dieser Endpunkt gibt die aktuellen Guthabensummen der Organisation zurück, die mit dem Management-Token verknüpft ist. Er verwendet dieselbe Quelle der Wahrheit für Organisationsguthaben wie Abrechnung und Settlement.

Hinweise

  • Monetäre Felder werden in USD zurückgegeben. Verwenden Sie balance, total_recharge und total_used für die Anzeige; für exakte Abrechnung verwenden Sie balance_decimal, total_recharge_decimal und total_used_decimal.

Beispiel

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Anfrage / Antwort

Verwenden Sie das interaktive OpenAPI-Panel oben für das genaue Schema.

Antwortbeispiel

{
  "object": "organization_balance",
  "organization_id": "org_123",
  "balance": 42.5,
  "balance_decimal": "42.50",
  "total_recharge": 100,
  "total_recharge_decimal": "100",
  "total_used": 57.5,
  "total_used_decimal": "57.50"
}

Wichtige Felder

object
string
Immer organization_balance.
organization_id
string
Organisation des aktuellen Management-Tokens.
balance
number
Aktuelles Organisationsguthaben in USD als JSON number für die Anzeige.
balance_decimal
string
Exaktes aktuelles Organisationsguthaben in USD als Dezimalzeichenfolge für die Abrechnung.
total_recharge
number
Gesamtsumme erfolgreicher Organisationsaufladungen in USD als JSON number für die Anzeige.
total_recharge_decimal
string
Exakte Gesamtsumme erfolgreicher Organisationsaufladungen in USD als Dezimalzeichenfolge für die Abrechnung.
total_used
number
Kumulierte Nutzungsausgaben der Organisation in USD als JSON number für die Anzeige.
total_used_decimal
string
Exakte kumulierte Nutzungsausgaben der Organisation in USD als Dezimalzeichenfolge für die Abrechnung.