GET
Calendário de gastos

Authorizations

Authorization
string
header
required

HTTP Basic com o token como usuário e o secret como senha: curl -u dpz_tk_…:dpz_sk_…. Crie a chave em https://despezzas.com/settings/api-keys.

Query Parameters

year
string

Ano (YYYY). Padrão: ano atual.

Example:

"2026"

account_ids
string[]

Filtra pelas contas informadas (repita o parâmetro ou use account_ids[]). Também aceita a forma account_ids[].

Example:
credit_card_ids
string[]

Filtra pelos cartões informados. Também aceita a forma credit_card_ids[].

Example:
tag_ids
string[]

Filtra pelas tags informadas. Também aceita a forma tag_ids[].

Example:

Response

Sucesso.

Mapa de calor anual de despesas: série esparsa (só dias com gasto), totais e o dia da semana em que você mais gasta.

available_years
integer[]
required

Anos com lançamentos.

Example:
days
object[]
required

Só os dias com gasto.

range
object
required
totals
object
required
weekdays
object[]
required

Os 7 dias da semana (0 = domingo).

year
integer
required

Ano.

Example:

2026

top_day
null | object

Dia de maior gasto, ou null.