curl --request GET \
--url https://api.despezzas.com/v1/reports/competence \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/reports/competence', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/reports/competence"
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/competence"
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))
}{
"basis": "competence",
"card_bridge": {
"bill_payments": 190000,
"card_purchases": 185000,
"card_refunds": 0,
"difference": -5000
},
"expenses_by_type": [
{
"amount": 380000,
"count": 22,
"share_percent": 62.8,
"type": "FIXED"
}
],
"monthly": [
{
"expenses": 605000,
"is_current": true,
"period": "2026-09",
"result": 195000,
"revenues": 800000,
"account_expenses": 420000,
"card_expenses": 185000
}
],
"previous_range": {
"end_date": "2026-08-31",
"start_date": "2026-08-01"
},
"range": {
"end_date": "2026-09-30",
"start_date": "2026-09-01"
},
"status": {
"pending_expenses": 120000,
"pending_revenues": 0,
"realized_expenses": 485000,
"realized_result": 315000,
"realized_revenues": 800000
},
"top_expenses": [
{
"amount": 250000,
"date": "2026-09-20",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"is_expense": true,
"paid": false,
"title": "Aluguel",
"type": "RECURRENT",
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"cash_date": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"title": "Alimentação",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
},
"credit_card_id": null,
"installment_label": null,
"is_bill_payment": false,
"is_overdue": false,
"logo_url": null
}
],
"top_incomes": [
{
"amount": 250000,
"date": "2026-09-20",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"is_expense": true,
"paid": false,
"title": "Aluguel",
"type": "RECURRENT",
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"cash_date": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"title": "Alimentação",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
},
"credit_card_id": null,
"installment_label": null,
"is_bill_payment": false,
"is_overdue": false,
"logo_url": null
}
],
"totals": {
"current": {
"account_expenses": 420000,
"card_expenses": 185000,
"expenses": 605000,
"result": 195000,
"revenues": 800000
},
"previous": {
"account_expenses": 450000,
"card_expenses": 190000,
"expenses": 640000,
"result": 140000,
"revenues": 780000
},
"variation_percent": {
"account_expenses": -6.7,
"card_expenses": -2.6,
"expenses": -5.5,
"result": 39.3,
"revenues": 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"
}Regime de competência
Escopo necessário: read.
curl --request GET \
--url https://api.despezzas.com/v1/reports/competence \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/reports/competence', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/reports/competence"
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/competence"
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))
}{
"basis": "competence",
"card_bridge": {
"bill_payments": 190000,
"card_purchases": 185000,
"card_refunds": 0,
"difference": -5000
},
"expenses_by_type": [
{
"amount": 380000,
"count": 22,
"share_percent": 62.8,
"type": "FIXED"
}
],
"monthly": [
{
"expenses": 605000,
"is_current": true,
"period": "2026-09",
"result": 195000,
"revenues": 800000,
"account_expenses": 420000,
"card_expenses": 185000
}
],
"previous_range": {
"end_date": "2026-08-31",
"start_date": "2026-08-01"
},
"range": {
"end_date": "2026-09-30",
"start_date": "2026-09-01"
},
"status": {
"pending_expenses": 120000,
"pending_revenues": 0,
"realized_expenses": 485000,
"realized_result": 315000,
"realized_revenues": 800000
},
"top_expenses": [
{
"amount": 250000,
"date": "2026-09-20",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"is_expense": true,
"paid": false,
"title": "Aluguel",
"type": "RECURRENT",
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"cash_date": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"title": "Alimentação",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
},
"credit_card_id": null,
"installment_label": null,
"is_bill_payment": false,
"is_overdue": false,
"logo_url": null
}
],
"top_incomes": [
{
"amount": 250000,
"date": "2026-09-20",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"is_expense": true,
"paid": false,
"title": "Aluguel",
"type": "RECURRENT",
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"cash_date": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"title": "Alimentação",
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null
},
"credit_card_id": null,
"installment_label": null,
"is_bill_payment": false,
"is_overdue": false,
"logo_url": null
}
],
"totals": {
"current": {
"account_expenses": 420000,
"card_expenses": 185000,
"expenses": 605000,
"result": 195000,
"revenues": 800000
},
"previous": {
"account_expenses": 450000,
"card_expenses": 190000,
"expenses": 640000,
"result": 140000,
"revenues": 780000
},
"variation_percent": {
"account_expenses": -6.7,
"card_expenses": -2.6,
"expenses": -5.5,
"result": 39.3,
"revenues": 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
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"]
Response
Sucesso.
Regime de competência: o que pertence ao período, pago ou não, com a ponte entre compras no cartão e pagamentos de fatura.
Regime.
competence "competence"
Show child attributes
Show child attributes
Despesas por tipo de lançamento.
Show child attributes
Show child attributes
Um balde por mês do intervalo.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Maiores despesas.
Show child attributes
Show child attributes
Maiores receitas.
Show child attributes
Show child attributes
Show child attributes
Show child attributes