curl --request GET \
--url https://api.despezzas.com/v1/transactions \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/transactions"
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/transactions"
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))
}[
{
"amount": 25990,
"createdAt": "2026-09-01T09:00:00.000Z",
"date": "2026-09-15T00:00:00.000Z",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"installments": 1,
"is_expense": true,
"paid": true,
"title": "Supermercado Pão de Açúcar",
"type": "FIXED",
"updatedAt": "2026-09-15T14:32:10.000Z",
"account": {
"id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"include_total_balance": true,
"is_default": true,
"logo": "https://cdn.despezzas.com/banks/nubank.png",
"name": "Nubank",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"balance": 1250000,
"createdAt": "2026-09-01T09:00:00.000Z",
"profile_id": null,
"subtype": null,
"type": "PERSONAL_BANK",
"updatedAt": "2026-09-15T14:32:10.000Z"
},
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"bill_id": null,
"billed_at": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"is_hidden": false,
"name": "Alimentação",
"createdAt": "2026-09-01T09:00:00.000Z",
"icon": null,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
},
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"competence_date": null,
"connected_transaction_id": null,
"contact_id": null,
"cost_center_id": null,
"credit_card": {
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"closing_date": "3",
"expiring_date": "10",
"id": "c4d5e6f7-0a1b-4c2d-9e3f-4a5b6c7d8e9f",
"logo": "https://cdn.despezzas.com/banks/nubank.png",
"name": "Nubank Mastercard",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"available_limit": 1315000,
"createdAt": "2026-09-01T09:00:00.000Z",
"is_unlimited": false,
"limit": 1500000,
"needs_closing_date_review": false,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z"
},
"credit_card_id": null,
"currency": "BRL",
"description": "Compra do mês",
"document_number": null,
"excluded_dates": [],
"frequency": "MONTHLY",
"installment_number": null,
"is_bill_payment": false,
"is_full_amount": false,
"is_previous_balance": false,
"is_remote": true,
"logo_url": null,
"merchant_cnae": null,
"merchant_cnpj": null,
"merchant_name": null,
"operation_type": null,
"paid_at": "2026-09-15T14:32:10.000Z",
"payment_dates": [],
"profile_id": null,
"projected_date": "2026-09-15T00:00:00.000Z",
"projected_installment": null,
"reconciled_at": null,
"reconciled_by_user_id": null,
"reconciled_with": {
"amount": 25990,
"date": "2026-09-16T00:00:00.000Z",
"id": "1d2e3f4a-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
"is_expense": true,
"paid": true,
"title": "PAO DE ACUCAR 1234",
"total": 25990,
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"credit_card_id": null,
"currency": "BRL",
"merchant_name": "Pão de Açúcar",
"reconciled_at": "2026-09-15T14:32:10.000Z",
"reconciled_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
},
"reconciled_with_transaction_id": null,
"reconciles": [
{
"amount": 25990,
"date": "2026-09-16T00:00:00.000Z",
"id": "1d2e3f4a-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
"is_expense": true,
"paid": true,
"title": "PAO DE ACUCAR 1234",
"total": 25990,
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"credit_card_id": null,
"currency": "BRL",
"merchant_name": "Pão de Açúcar",
"reconciled_at": "2026-09-15T14:32:10.000Z",
"reconciled_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
],
"show_on_balance": true,
"subcategory": {
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"is_essential": true,
"is_hidden": false,
"name": "Supermercado",
"createdAt": "2026-09-01T09:00:00.000Z",
"icon_background_color": "#F97316",
"icon_name": "shopping-cart",
"image": null,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
},
"subcategory_id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"tags": [
{
"color": "#0EA5E9",
"id": "e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b",
"name": "Viagem",
"createdAt": "2026-09-01T09:00:00.000Z",
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
],
"total": 25990,
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
]{
"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"
}Listar lançamentos
Retorna um array (sem envelope) com os lançamentos do contexto da chave, com relações expandidas e campos calculados. Sem filtros, traz o mês atual. Valores em centavos.
Escopo necessário: read.
curl --request GET \
--url https://api.despezzas.com/v1/transactions \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v1/transactions"
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/transactions"
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))
}[
{
"amount": 25990,
"createdAt": "2026-09-01T09:00:00.000Z",
"date": "2026-09-15T00:00:00.000Z",
"id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"installments": 1,
"is_expense": true,
"paid": true,
"title": "Supermercado Pão de Açúcar",
"type": "FIXED",
"updatedAt": "2026-09-15T14:32:10.000Z",
"account": {
"id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"include_total_balance": true,
"is_default": true,
"logo": "https://cdn.despezzas.com/banks/nubank.png",
"name": "Nubank",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"balance": 1250000,
"createdAt": "2026-09-01T09:00:00.000Z",
"profile_id": null,
"subtype": null,
"type": "PERSONAL_BANK",
"updatedAt": "2026-09-15T14:32:10.000Z"
},
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"bill_id": null,
"billed_at": null,
"category": {
"id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"is_essential": true,
"is_hidden": false,
"name": "Alimentação",
"createdAt": "2026-09-01T09:00:00.000Z",
"icon": null,
"icon_background_color": "#F97316",
"icon_name": "restaurant",
"image": null,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
},
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"competence_date": null,
"connected_transaction_id": null,
"contact_id": null,
"cost_center_id": null,
"credit_card": {
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"closing_date": "3",
"expiring_date": "10",
"id": "c4d5e6f7-0a1b-4c2d-9e3f-4a5b6c7d8e9f",
"logo": "https://cdn.despezzas.com/banks/nubank.png",
"name": "Nubank Mastercard",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"available_limit": 1315000,
"createdAt": "2026-09-01T09:00:00.000Z",
"is_unlimited": false,
"limit": 1500000,
"needs_closing_date_review": false,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z"
},
"credit_card_id": null,
"currency": "BRL",
"description": "Compra do mês",
"document_number": null,
"excluded_dates": [],
"frequency": "MONTHLY",
"installment_number": null,
"is_bill_payment": false,
"is_full_amount": false,
"is_previous_balance": false,
"is_remote": true,
"logo_url": null,
"merchant_cnae": null,
"merchant_cnpj": null,
"merchant_name": null,
"operation_type": null,
"paid_at": "2026-09-15T14:32:10.000Z",
"payment_dates": [],
"profile_id": null,
"projected_date": "2026-09-15T00:00:00.000Z",
"projected_installment": null,
"reconciled_at": null,
"reconciled_by_user_id": null,
"reconciled_with": {
"amount": 25990,
"date": "2026-09-16T00:00:00.000Z",
"id": "1d2e3f4a-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
"is_expense": true,
"paid": true,
"title": "PAO DE ACUCAR 1234",
"total": 25990,
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"credit_card_id": null,
"currency": "BRL",
"merchant_name": "Pão de Açúcar",
"reconciled_at": "2026-09-15T14:32:10.000Z",
"reconciled_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
},
"reconciled_with_transaction_id": null,
"reconciles": [
{
"amount": 25990,
"date": "2026-09-16T00:00:00.000Z",
"id": "1d2e3f4a-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
"is_expense": true,
"paid": true,
"title": "PAO DE ACUCAR 1234",
"total": 25990,
"account_id": "3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f",
"credit_card_id": null,
"currency": "BRL",
"merchant_name": "Pão de Açúcar",
"reconciled_at": "2026-09-15T14:32:10.000Z",
"reconciled_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
],
"show_on_balance": true,
"subcategory": {
"category_id": "b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"is_essential": true,
"is_hidden": false,
"name": "Supermercado",
"createdAt": "2026-09-01T09:00:00.000Z",
"icon_background_color": "#F97316",
"icon_name": "shopping-cart",
"image": null,
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
},
"subcategory_id": "d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a",
"tags": [
{
"color": "#0EA5E9",
"id": "e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b",
"name": "Viagem",
"createdAt": "2026-09-01T09:00:00.000Z",
"profile_id": null,
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
],
"total": 25990,
"user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5"
}
]{
"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
Mês de referência no formato YYYY-MM-DD (qualquer dia do mês). Padrão: mês atual.
"2026-09-01"
Início do intervalo (YYYY-MM-DD). Sobrepõe date quando usado com date_end.
"2026-09-01"
Fim do intervalo (YYYY-MM-DD).
"2026-09-30"
Busca por título/descrição.
"mercado"
Filtra pelas categorias informadas. Também aceita a forma category_ids[].
["b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"]
Filtra pelas subcategorias informadas. Também aceita a forma subcategory_ids[].
["d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a"]
Filtra pelas tags informadas. Também aceita a forma tag_ids[].
["e2f3a4b5-c6d7-4e8f-9a0b-1c2d3e4f5a6b"]
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"]
"true" só despesas, "false" só receitas.
true, false "true"
"true" só pagos, "false" só pendentes.
true, false "true"
Tipo de conta.
PERSONAL_BANK, BUSINESS_BANK, INVESTMENT, OTHER "PERSONAL_BANK"
Tipos de lançamento (FIXED, RECURRENT, PARCELLED, TRANSFER); repita o parâmetro ou separe por vírgula. Também aceita a forma types[].
["FIXED"]
Restringe à fatura informada.
"f6a7b8c9-d0e1-4f2a-8b3c-4d5e6f7a8b9c"
Valor exato em reais (ex.: 259.9).
259.9
Oculta lançamentos previstos que já foram conciliados.
true
Campo de ordenação.
"date"
Direção da ordenação.
asc, desc "asc"
Response
Sucesso.
Valor, sempre positivo — o sinal vem de is_expense. Em centavos.
25990
Criação.
"2026-09-01T09:00:00.000Z"
Data do lançamento.
"2026-09-15T00:00:00.000Z"
Id do lançamento.
"8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b"
Quantidade de parcelas (1 quando à vista).
1
true = despesa, false = receita.
true
Pago/recebido.
true
Título.
"Supermercado Pão de Açúcar"
Tipo do lançamento.
FIXED, RECURRENT, PARCELLED, TRANSFER "FIXED"
Última alteração.
"2026-09-15T14:32:10.000Z"
Conta expandida (quando o lançamento é de conta).
Show child attributes
Show child attributes
Conta (lançamentos de conta).
"3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f"
Fatura à qual pertence.
null
Data de faturamento (cartão).
null
Categoria expandida, já traduzida/editada para o contexto.
Show child attributes
Show child attributes
Categoria.
"b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
Competência (Business).
null
Liga as parcelas/recorrências de uma mesma série.
null
Contato (Business).
null
Centro de custo (Business).
null
Cartão expandido (quando o lançamento é de cartão).
Show child attributes
Show child attributes
Cartão (lançamentos de cartão — sempre pagos).
null
Moeda.
"BRL"
Descrição livre.
"Compra do mês"
Número do documento (Business).
null
Sempre vazio (campo legado).
[]
Frequência (só faz sentido em RECURRENT).
DAILY, WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUAL, YEARLY "MONTHLY"
Número desta parcela.
null
Se é o pagamento de uma fatura.
false
Em parcelamentos, se amount foi informado como o total da compra.
false
Se é saldo anterior de fatura.
false
Sempre true (campo legado).
true
Logo do estabelecimento.
null
CNAE do estabelecimento (Open Finance).
null
CNPJ do estabelecimento (Open Finance).
null
Nome do estabelecimento (Open Finance).
null
Tipo de operação informado pelo banco (Open Finance).
null
Quando foi pago.
"2026-09-15T14:32:10.000Z"
Sempre vazio (campo legado).
[]
Perfil de Acesso / empresa (nulo no contexto pessoal).
null
Data projetada da ocorrência (recorrências) — igual a date nos demais.
"2026-09-15T00:00:00.000Z"
Número projetado da parcela (nulo fora de parcelamentos).
null
Quando foi conciliado.
null
Quem conciliou.
null
O pagamento real que substituiu este lançamento previsto (nulo quando não conciliado).
Show child attributes
Show child attributes
Lançamento real com o qual este previsto foi conciliado.
null
Lançamentos previstos que este pagamento real liquidou.
Show child attributes
Show child attributes
Se entra no saldo.
true
Subcategoria expandida.
Show child attributes
Show child attributes
Subcategoria.
"d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a"
Tags aplicadas.
Show child attributes
Show child attributes
Valor a exibir: em parcelamentos com is_full_amount, a parcela; caso contrário igual a amount. Em centavos.
25990
Dono do lançamento.
"0d6b923c-3392-424e-a152-2ee32474e8d5"