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

# Consultar Saldo

> Retorna o saldo disponível e em processamento da conta

## Descrição

Retorna o saldo disponível para saque e o saldo em processamento (valor reservado de saques em andamento).

***

## Headers

**Authorization** `string` *required* (default: Bearer YOUR\_API\_KEY)

Bearer token de autenticação. Formato: `Bearer YOUR_API_KEY`

***

## Exemplo de Requisição

```bash cURL theme={null}
curl https://api.visepag.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript Node.js theme={null}
const response = await fetch('https://api.visepag.com/v1/balance', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const balance = await response.json();
console.log(`Disponível: ${balance.available[0].amount} centavos`);
```

```python Python theme={null}
import requests

balance = requests.get(
    'https://api.visepag.com/v1/balance',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
).json()

print(f"Disponível: {balance['available'][0]['amount']} centavos")
```

***

## Resposta `200 OK`

**object** `string`

Sempre `"balance"`

**available** `array`

Saldo disponível por moeda

**Propriedades**

**available\[].amount** `integer`

Saldo disponível em **centavos**

**available\[].currency** `string`

Moeda (`brl`)

**processing** `array`

Saldo em processamento por moeda

**Propriedades**

**processing\[].amount** `integer`

Valor reservado de saques em andamento, em **centavos**

**processing\[].currency** `string`

Moeda (`brl`)

**livemode** `boolean`

Sempre `true`

```json 200 theme={null}
{
  "object": "balance",
  "available": [
    { "amount": 150000, "currency": "brl" }
  ],
  "processing": [
    { "amount": 25000, "currency": "brl" }
  ],
  "livemode": true
}
```

***

## Como o saldo muda

* **Cobrança paga:** o valor menos a taxa da VisePag entra no `available` na hora.
* **Saque pedido:** o valor sai do `available` e fica em `processing`.
* **Saque concluído:** o valor sai do `processing`.
* **Saque falhou:** o valor volta do `processing` para o `available`.


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