> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization Balance

> Returns current organization balance totals for the management token.

## 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

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
    -H "Authorization: Bearer mt-your-management-token"
  ```
</RequestExample>

## Request / Response

Use the interactive OpenAPI panel above for the exact schema.

## Response example

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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"
  }
  ```
</ResponseExample>

## Important fields

<ResponseField name="object" type="string">Always `organization_balance`.</ResponseField>
<ResponseField name="organization_id" type="string">Organization associated with the current management token.</ResponseField>
<ResponseField name="balance" type="number">Current organization balance in USD as a JSON number for display.</ResponseField>
<ResponseField name="balance_decimal" type="string">Exact current organization balance in USD as a decimal string for reconciliation.</ResponseField>
<ResponseField name="total_recharge" type="number">Total successful organization recharge amount in USD as a JSON number for display.</ResponseField>
<ResponseField name="total_recharge_decimal" type="string">Exact total successful organization recharge amount in USD as a decimal string for reconciliation.</ResponseField>
<ResponseField name="total_used" type="number">Total organization usage spend in USD as a JSON number for display.</ResponseField>
<ResponseField name="total_used_decimal" type="string">Exact total organization usage spend in USD as a decimal string for reconciliation.</ResponseField>