---
title: "Histórico de saldo de uma ou mais contas"
method: GET
path: "/api/v1/accounts/balance-history"
tags: ["Contas"]
---

# Histórico de saldo de uma ou mais contas

`GET /api/v1/accounts/balance-history`

## Request

- Base URL: `https://snabber.com.br`
- URL: `https://snabber.com.br/api/v1/accounts/balance-history`
- Auth: HTTP bearer

Retorna o histórico diário de saldo (`account_balance_history`) de uma ou mais contas do workspace vinculado à chave de API, filtrado por período. Aceita `account_id` repetido (`account_id=1&account_id=2`) ou separado por vírgula (`account_id=1,2`) para trazer várias contas de uma vez; se omitido, traz todas as contas do workspace. Por padrão retorna uma linha por conta/dia (`BalanceHistoryList`); com `group_by=day`, o resultado vem agrupado por data — cada dia traz o último saldo de cada conta pedida, lado a lado, mais `total` somando os saldos do dia (`BalanceHistoryDayList`). Contas informadas precisam pertencer a esse workspace.

## Query parameters

- `workspace_id` integer
- `account_id` string
- `from` string, date
- `to` string, date
- `group_by` 'day'

## Response `200`

Histórico de saldo (BalanceHistoryList, ou BalanceHistoryDayList quando group_by=day)

- BalanceHistoryList
  - `data` BalanceHistoryEntry[]
    - `id` integer
    - `account_id` integer
    - `date` string, date
    - `balance` number, nullable
    - `currency_code` string
    - `updated_at` string, date-time
  - `meta` object
    - `workspace_id` integer
    - `account_id` union: Id único, ou lista de ids quando mais de uma conta foi pedida
      - integer
      - integer[]

## Other responses

- `400`: Parâmetro inválido
- `401`: Chave de API ausente, inválida, revogada ou expirada
- `403`: Plano do usuário não tem acesso à API (downgrade para free)
- `404`: Conta não encontrada neste workspace
- `429`: Limite de requisições excedido

---

[API](https://skmtc.dev/snabber/apis/snabber-api.md) · [All operations](https://skmtc.dev/snabber/apis/snabber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snabber/apis/snabber-api/revisions/bf5841cbd8ce?raw)