Skip to main content

​
Overview

This endpoint returns the current balance totals for the organization associated with the management token. It uses the same organization balance current reference as billing and settlement.

​
Notes

  • Monetary fields are USD-only. CNY inputs are retired and return 400 currency_retired.
  • Monetary fields are returned in USD. Use balance, total_recharge, and total_used for display; use balance_decimal, total_recharge_decimal, and total_used_decimal for exact billing reconciliation.

​
Example

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

​
Request / Response

Use the interactive OpenAPI panel above for the exact schema.

​
Response example

{
  "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"
}

​
Important fields

​
object
string
Always organization_balance.
​
organization_id
string
Organization associated with the current management token.
​
balance
number
Current organization balance in USD as a JSON number for display.
​
balance_decimal
string
Exact current organization balance in USD as a decimal string for reconciliation.
​
total_recharge
number
Total successful organization recharge amount in USD as a JSON number for display.
​
total_recharge_decimal
string
Exact total successful organization recharge amount in USD as a decimal string for reconciliation.
​
total_used
number
Total organization usage spend in USD as a JSON number for display.
​
total_used_decimal
string
Exact total organization usage spend in USD as a decimal string for reconciliation.