Paginação e filtros - Despezzas API

Listas devolvem arrays

As rotas de listagem (GET /v1/transactions, /v1/accounts, /v1/tags…) devolvem um array puro, sem envelope. Não há paginação por página: o recorte é feito pelos filtros de período.

Lançamentos

GET /v1/transactions sem parâmetros devolve o mês atual. Para outro mês, use date (qualquer dia do mês):

curl -u "$TOKEN:$SECRET" "https://api.despezzas.com/v1/transactions?date=2026-08-01"

Para um intervalo arbitrário, date_start e date_end:

curl -u "$TOKEN:$SECRET" \
  "https://api.despezzas.com/v1/transactions?date_start=2026-01-01&date_end=2026-03-31"

Filtros combináveis:

Parâmetro	Exemplo	Efeito
`search`	`search=mercado`	Busca no título e descrição.
`is_expense`	`is_expense=true`	Só despesas (`false` = só receitas).
`is_paid`	`is_paid=false`	Só pendentes.
`category_ids`	`category_ids=abc&category_ids=def`	Uma ou mais categorias. Também aceita `category_ids[]=abc`.
`subcategory_ids`, `tag_ids`, `account_ids`, `credit_card_ids`	idem	Filtros por id, repetíveis.
`types`	`types=TRANSFER`	Tipo do lançamento (`FIXED`, `PARCELLED`, `RECURRENT`, `TRANSFER`); repetível ou separado por vírgula.
`value`	`value=59.9`	Valor exato em reais.
`bill_id`	`bill_id=…`	Só os lançamentos de uma fatura.
`hide_reconciled`	`hide_reconciled=true`	Oculta previstos já conciliados.
`order_by`, `order`	`order_by=date&order=asc`	Ordenação.

Valores e datas

Todo valor monetário é um inteiro em centavos: 5990 = R$ 59,90. O sinal vem de is_expense, nunca do número.
Datas de lançamento aceitam YYYY-MM-DD; timestamps saem como ISO 8601 em UTC (2026-09-20T14:30:00.000Z).
Ids são strings (UUID).