GET
Previsão

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

months
integer

Meses a projetar (1–12). Padrão: 6.

Example:

6

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:

Response

Sucesso.

Projeção dos próximos meses a partir do histórico: compromissos, recorrências detectadas e estimativas por categoria.

as_of
string
required

Data de referência (YYYY-MM-DD).

Example:

"2026-09-15"

averages
object
required
basis
enum<string>
required

Regime.

Available options:
cash
Example:

"cash"

confidence
enum<string>
required

Confiança da projeção.

Available options:
low,
medium,
high
Example:

"high"

current_balance
integer
required

Saldo atual. Em centavos.

Example:

1250000

estimated_by_category
object
required
forecast
object[]
required

Meses projetados.

history
object[]
required

Meses passados usados na projeção.

history_months
integer
required

Meses de histórico considerados.

Example:

6

history_months_used
integer
required

Meses de histórico com dados.

Example:

6

months
integer
required

Meses projetados.

Example:

3

totals
object
required