Obtenha uma lista de transações financeiras
Retorna lista de transações financeiras com diversos filtros opcionais incluindo informações de processos, clientes, datas e dados financeiros.
Como funcionam os filtros:
- Múltiplos filtros são combinados com AND (interseção)
- Filtros de texto como
responsible,customer_name,debit_bank,description,categoryecost_centersão busca parcial (case-insensitive) - Filtros como
lawsuit_id,process_numbersão busca exata - Filtros de data funcionam como range (use _start e _end juntos)
competence_start/endusa formato MM/YYYY (ex: 03/2026), diferente dos demais filtros de data
A resposta inclui totalCount, limit, offset e array data com as transações.
Authorization
BearerAuth In: header
Query Parameters
[Optional] ID exato do processo associado à transação.
[Optional] Busca parcial na categoria da transação. Case-insensitive. Exemplos: ALUGUEL, HONORÁRIOS, ENERGIA.
[Optional] Busca parcial no nome do responsável. Case-insensitive.
[Optional] Busca parcial no nome do cliente. Case-insensitive.
[Optional] Busca parcial no banco de débito. Case-insensitive.
[Optional] Busca parcial no centro de custo. Case-insensitive.
[Optional] Busca parcial na descrição da transação. Case-insensitive.
[Optional] Número exato do processo associado à transação (ex: 5003807-92.2020.8.24.0067). Busca exata - não aceita busca parcial.
[Optional] Número do protocolo associado à transação.
[Optional] CPF ou CNPJ do cliente. IMPORTANTE: Validação obrigatória - deve ser CPF/CNPJ válido, caso contrário retorna erro Invalid identification.
^([0-9]{3}\.?[0-9]{3}\.?[0-9]{3}-?[0-9]{2}|[0-9]{2}\.?[0-9]{3}\.?[0-9]{3}/?[0-9]{4}-?[0-9]{2})$[Optional] Data inicial para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado junto com created_end.
date[Optional] Data final para filtrar por data de criação (formato: YYYY-MM-DD). Deve ser usado junto com created_start.
date[Optional] Data inicial para filtrar por data de vencimento (formato: YYYY-MM-DD). Deve ser usado junto com date_due_end.
date[Optional] Data final para filtrar por data de vencimento (formato: YYYY-MM-DD). Deve ser usado junto com date_due_start.
date[Optional] Data inicial para filtrar por data de pagamento (formato: YYYY-MM-DD). Deve ser usado junto com date_payment_end.
date[Optional] Data final para filtrar por data de pagamento (formato: YYYY-MM-DD). Deve ser usado junto com date_payment_start.
date[Optional] Competência inicial para filtrar (formato: MM/YYYY, ex: 03/2026). Deve ser usado junto com competence_end.
^(0[1-9]|1[0-2])/\d{4}$[Optional] Competência final para filtrar (formato: MM/YYYY, ex: 03/2026). Deve ser usado junto com competence_start.
^(0[1-9]|1[0-2])/\d{4}$Response Body
application/json
application/json
application/json
curl -X GET "https://app.advbox.com.br/api/v1/transactions"{
"offset": 0,
"limit": 1000,
"totalCount": 42,
"data": [
{
"id": 5000001,
"entry_type": "income",
"date_due": "2026-04-30",
"date_payment": null,
"competence": "04/2026",
"amount": 5000,
"description": "HONORARIOS CONTRATUAIS",
"responsible": "MARIA SILVA",
"category": "HONORARIOS INICIAIS",
"lawsuit_id": 1234501,
"process_number": "0001234-56.2026.5.15.0001",
"protocol_number": null,
"name": "JOAO PEREIRA",
"identification": "111.222.333-44",
"debit_bank": "CONTA PRINCIPAL",
"credit_bank": null,
"cost_center": "GERAL"
},
{
"id": 5000002,
"entry_type": "expense",
"date_due": "2026-04-15",
"date_payment": "2026-04-15",
"competence": "04/2026",
"amount": 350,
"description": null,
"responsible": "CARLOS SOUZA",
"category": "CUSTAS PROCESSUAIS",
"lawsuit_id": null,
"process_number": null,
"protocol_number": null,
"name": null,
"identification": null,
"debit_bank": "CONTA PRINCIPAL",
"credit_bank": null,
"cost_center": "GERAL"
}
]
}{
"error": "Invalid identification."
}{
"error": "Unauthenticated."
}