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

# Consultar Saldo

> Consulte o saldo disponível da conta e os valores bloqueados.

A consulta de saldo retorna quanto a conta tem disponível para movimentar e quanto está bloqueado, separado por motivo do bloqueio.

Use o saldo disponível para validar se uma transferência ou um pagamento cabe na conta antes de enviá-lo. Isso evita o erro de saldo insuficiente em [Pix](https://docs.delfinance.com.br/guias/pix/pagar-pix/troubleshooting.md), TED e [pagamento de contas](https://docs.delfinance.com.br/guias/pagamento-contas/troubleshooting.md).

## Consultar o saldo

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/balances' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```json Response theme={null}
{
    "amountAvailable": 15230.40,
    "amountJudicialyBlocked": 0.00,
    "amountTempBlocked": 0.00,
    "amountPixBlocked": 200.99,
    "amountTempBlockedOperationInternal": 250.00,
    "amountBlockedForDebit": 0.00
}
```

## Campos da resposta

| Campo | Descrição |
| - | - |
| `amountAvailable` | Saldo disponível para movimentar. É o valor que você pode transferir ou usar em pagamentos |
| `amountJudicialyBlocked` | Valor bloqueado por ordem judicial |
| `amountTempBlocked` | Valor com bloqueio temporário |
| `amountPixBlocked` | Valor bloqueado em transações Pix, por exemplo por uma [notificação de infração (MED)](https://docs.delfinance.com.br/guias/webhooks/meds.md) |
| `amountTempBlockedOperationInternal` | Valor com bloqueio temporário por operação interna |
| `amountBlockedForDebit` | Valor reservado para um débito já programado |

> [!NOTE]
>
> Os valores bloqueados **não** fazem parte do `amountAvailable`. Para mostrar o saldo bloqueado total, some os cinco campos de bloqueio.

## Saldo e extrato

O saldo mostra a posição atual da conta. Para ver como a conta chegou nesse valor, use o [extrato](https://docs.delfinance.com.br/guias/conta/extrato.md). Cada transação do extrato traz o saldo antes e depois do lançamento, no objeto `balance`.

> [!TIP]
>
> Não consulte o saldo em loop para detectar recebimentos. Os créditos chegam via [webhooks](https://docs.delfinance.com.br/guias/webhooks/visao-geral.md).

## Referência da API

> **[Consultar saldo](https://docs.delfinance.com.br/api-reference/conta/consultar-saldo.md)**
>
> `GET /baas/api/v1/balances`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.