Gastos por cartão
curl --request GET \
--url https://api.despezzas.com/v1/dashboard/credit-card-spending \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/dashboard/credit-card-spending', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/dashboard/credit-card-spending"
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/dashboard/credit-card-spending"
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))
}{
"categories_top5": [
{
"current_cents": 92000,
"name": "Alimentação",
"percent_of_period": 49.7,
"previous_cents": 88000,
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"variation_percent": 4.5
}
],
"daily_breakdown": [
{
"amount_cents": 25990,
"date": "2026-09-15"
}
],
"meta": {
"total_categories": 9
},
"previous_range": {
"end_date": "2026-08-31",
"start_date": "2026-08-01"
},
"range": {
"end_date": "2026-09-30",
"start_date": "2026-09-01"
},
"totals": {
"current_cents": 185000,
"previous_cents": 190000,
"variation_percent": -2.6
}
}{
"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órios
Gastos por cartão
Escopo necessário: read.
GET
/
v1
/
dashboard
/
credit-card-spending
Gastos por cartão
curl --request GET \
--url https://api.despezzas.com/v1/dashboard/credit-card-spending \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/dashboard/credit-card-spending', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/dashboard/credit-card-spending"
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/dashboard/credit-card-spending"
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))
}{
"categories_top5": [
{
"current_cents": 92000,
"name": "Alimentação",
"percent_of_period": 49.7,
"previous_cents": 88000,
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"variation_percent": 4.5
}
],
"daily_breakdown": [
{
"amount_cents": 25990,
"date": "2026-09-15"
}
],
"meta": {
"total_categories": 9
},
"previous_range": {
"end_date": "2026-08-31",
"start_date": "2026-08-01"
},
"range": {
"end_date": "2026-09-30",
"start_date": "2026-09-01"
},
"totals": {
"current_cents": 185000,
"previous_cents": 190000,
"variation_percent": -2.6
}
}{
"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
basicAuthapiSecret & apiToken
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).
Example:
"2026-09-01"
Fim do período (YYYY-MM-DD).
Example:
"2026-09-30"
Response
Sucesso.
Gastos no cartão no período contra o período anterior, por dia e por categoria.
As 5 categorias com mais gasto.
Show child attributes
Show child attributes
Gasto por dia.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes