Distribuição por tipo
curl --request GET \
--url https://api.despezzas.com/v1/investments/breakdown \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/investments/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/investments/breakdown"
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/investments/breakdown"
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))
}{
"group_by": "subcategory",
"items": [
{
"contributions_cents": 200000,
"dividends_cents": 8000,
"id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"name": "Tesouro Direto",
"percent_of_total": 66.7,
"transaction_count": 2,
"color": "#0EA5E9",
"image": null
}
],
"total_cents": 300000
}{
"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"
}Investimentos
Distribuição por tipo
Escopo necessário: read.
GET
/
v1
/
investments
/
breakdown
Distribuição por tipo
curl --request GET \
--url https://api.despezzas.com/v1/investments/breakdown \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/investments/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/investments/breakdown"
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/investments/breakdown"
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))
}{
"group_by": "subcategory",
"items": [
{
"contributions_cents": 200000,
"dividends_cents": 8000,
"id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"name": "Tesouro Direto",
"percent_of_total": 66.7,
"transaction_count": 2,
"color": "#0EA5E9",
"image": null
}
],
"total_cents": 300000
}{
"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"
Agrupamento. Padrão: subcategory.
Available options:
subcategory, account Example:
"subcategory"
Filtra pelas contas informadas (repita o parâmetro ou use account_ids[]). Também aceita a forma account_ids[].
Example:
["3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f"]