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

# 取得組織餘額

> 返回目前管理令牌所屬組織的餘額彙總。

## 概覽

這個端點返回目前管理令牌所屬組織的餘額彙總。它使用與計費和結算相同的組織餘額事實源。

## 注意事項

* 金額欄位以 USD 返回。展示可使用 `balance`、`total_recharge`、`total_used`；精確計費對帳請使用 `balance_decimal`、`total_recharge_decimal`、`total_used_decimal`。

## 範例

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

## 請求 / 回應

使用上方的互動式 OpenAPI 面板以取得確切的架構。

## 回應範例

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

## 重要欄位

<ResponseField name="object" type="string">固定為 `organization_balance`。</ResponseField>
<ResponseField name="organization_id" type="string">目前管理權杖所屬的組織。</ResponseField>
<ResponseField name="balance" type="number">目前組織餘額，USD JSON number，用於展示。</ResponseField>
<ResponseField name="balance_decimal" type="string">目前組織餘額，USD 精確十進位字串，用於對帳。</ResponseField>
<ResponseField name="total_recharge" type="number">組織成功充值總額，USD JSON number，用於展示。</ResponseField>
<ResponseField name="total_recharge_decimal" type="string">組織成功充值總額，USD 精確十進位字串，用於對帳。</ResponseField>
<ResponseField name="total_used" type="number">組織累計用量消費，USD JSON number，用於展示。</ResponseField>
<ResponseField name="total_used_decimal" type="string">組織累計用量消費，USD 精確十進位字串，用於對帳。</ResponseField>
