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

# Obter saldo da organização

> Retorna os totais atuais de saldo da organização para o token de gerenciamento.

## Visão Geral

Este endpoint retorna os totais atuais de saldo da organização associada ao token de gerenciamento. Ele usa a mesma referência atual de saldo da organização usada por faturamento e liquidação.

## Notas

* Os campos monetários são retornados em USD. Use `balance`, `total_recharge` e `total_used` para exibição; use `balance_decimal`, `total_recharge_decimal` e `total_used_decimal` para reconciliação exata.

## Exemplo

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

## Solicitação / Resposta

Use o painel interativo OpenAPI acima para o esquema exato.

## Exemplo de resposta

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

## Campos importantes

<ResponseField name="object" type="string">Sempre `organization_balance`.</ResponseField>
<ResponseField name="organization_id" type="string">Organização associada ao token de gerenciamento atual.</ResponseField>
<ResponseField name="balance" type="number">Saldo atual da organização em USD como JSON number para exibição.</ResponseField>
<ResponseField name="balance_decimal" type="string">Saldo atual exato da organização em USD como string decimal para reconciliação.</ResponseField>
<ResponseField name="total_recharge" type="number">Total de recargas bem-sucedidas da organização em USD como JSON number para exibição.</ResponseField>
<ResponseField name="total_recharge_decimal" type="string">Total exato de recargas bem-sucedidas da organização em USD como string decimal para reconciliação.</ResponseField>
<ResponseField name="total_used" type="number">Gasto acumulado de uso da organização em USD como JSON number para exibição.</ResponseField>
<ResponseField name="total_used_decimal" type="string">Gasto acumulado exato de uso da organização em USD como string decimal para reconciliação.</ResponseField>