curl --request GET \
--url https://api.despezzas.com/v1/reports \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/reports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/reports"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v1/reports"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"expenses": {
"account_expenses": 420000,
"card_expenses": 185000
},
"expenses_categories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "34.71",
"title": "Alimentação",
"value": 210000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"expenses_subcategories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "24.79",
"title": "Supermercado",
"value": 150000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"expenses_tags": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "14.88",
"title": "Viagem",
"value": 90000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes": {
"refunds": 0,
"revenues": 800000
},
"incomes_categories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "100.00",
"title": "Salário",
"value": 800000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes_subcategories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "100.00",
"title": "Salário",
"value": 800000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes_tags": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "0.00",
"title": "Freela",
"value": 0,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"overview": {
"balance": 195000,
"expenses": 605000,
"revenues": 800000
}
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Relatório do período
Totais e rankings por categoria, subcategoria e tag no período. Sem datas, usa o mês atual.
Escopo necessário: read.
curl --request GET \
--url https://api.despezzas.com/v1/reports \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/reports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/reports"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v1/reports"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"expenses": {
"account_expenses": 420000,
"card_expenses": 185000
},
"expenses_categories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "34.71",
"title": "Alimentação",
"value": 210000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"expenses_subcategories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "24.79",
"title": "Supermercado",
"value": 150000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"expenses_tags": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "14.88",
"title": "Viagem",
"value": 90000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes": {
"refunds": 0,
"revenues": 800000
},
"incomes_categories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "100.00",
"title": "Salário",
"value": 800000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes_subcategories": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "100.00",
"title": "Salário",
"value": 800000,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"incomes_tags": [
{
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"percentage": "0.00",
"title": "Freela",
"value": 0,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
}
],
"overview": {
"balance": 195000,
"expenses": 605000,
"revenues": 800000
}
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Authorizations
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
Início do período (YYYY-MM-DD).
"2026-09-01"
Fim do período (YYYY-MM-DD).
"2026-09-30"
Filtra pelas contas informadas (repita o parâmetro ou use account_ids[]). Também aceita a forma account_ids[].
["3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f"]
Filtra pelos cartões informados. Também aceita a forma credit_card_ids[].
["c4d5e6f7-0a1b-4c2d-9e3f-4a5b6c7d8e9f"]
Filtra pelas tags informadas. Também aceita a forma tag_ids[].
["e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b"]
Campo de ordenação.
"date"
Direção da ordenação.
asc, desc "asc"
Response
Sucesso.
Totais do período e rankings por categoria, subcategoria e tag.
Show child attributes
Show child attributes
Despesas por categoria.
Show child attributes
Show child attributes
Despesas por subcategoria.
Show child attributes
Show child attributes
Despesas por tag.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Receitas por categoria.
Show child attributes
Show child attributes
Receitas por subcategoria.
Show child attributes
Show child attributes
Receitas por tag.
Show child attributes
Show child attributes
Show child attributes
Show child attributes