# Consultar saldo (/docs/conta-digital/endpoints/account/get_balance)

## GET /transactions/balance

`GET https://api.hub.payzu.com.br/api/v1/transactions/balance`

Escopo: `STATEMENT_READ`. Devolve o saldo disponível e o bloqueado da conta, com o bloqueado separado por motivo.

### Responses

**200** Saldo.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `total` | integer | yes | `available + blocked`. Em centavos. |
| `available` | integer | yes | Saldo disponível para saque, pagamento de Pix copia e cola e estorno. É o total das linhas do extrato. Em centavos. |
| `blocked` | integer | yes | Saldo na conta que não pode ser usado: a soma dos três campos abaixo. Em centavos. |
| `blockedBySecurity` | integer | yes | Preso por contestação MED aberta e por outros bloqueios que não são de saque nem de estorno, como o valor de uma transferência ainda sem resultado. Em centavos. |
| `blockedByWithdraw` | integer | yes | Preso por saque ainda sendo processado. Em centavos. |
| `blockedByRefund` | integer | yes | Preso por estorno ainda sendo processado. Em centavos. |
| `syncedAt` | string | yes | Instante da resposta. — format: date-time |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**412** Falta um passo antes desta operação.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |