Retornar as transferências entre contas financeiras por filtro

Request

Permite consultar as transferências realizadas entre contas financeiras mediante filtros como período de datas e contas financeiras específicas. Para viabilizar a conciliação financeira automática e sincronizar corretamente as movimentações no meu sistema.

Security

BearerAuth

Query

paginainteger, >= 1

Número da página para paginação dos resultados

Default:1

Example:pagina=1

tamanho_paginainteger

Quantidade de itens por página

Default:10

Enum:1020501002005001000

Example:tamanho_pagina=10

ids_conta_financeiraArray of strings, (uuid)

Lista de identificadores (UUIDs) das contas financeiras para filtrar as transferências. Retorna transferências onde as contas especificadas sejam origem ou destino.

Example:ids_conta_financeira=35473eec-4e74-11ee-b500-9f61de8a8b8b&ids_conta_financeira=8f2a3e45-1c9d-4b3a-a7f1-9e8d7c6b5a4f

data_iniciostring, (date)

Data inicial do período para filtrar as transferências (formato ISO date)

Example:data_inicio=2026-01-01

data_fimstring, (date)

Data final do período para filtrar as transferências (formato ISO date)

Example:data_fim=2026-12-31

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/financeiro/transferencias?pagina=1&tamanho_pagina=10&ids_conta_financeira=35473eec-4e74-11ee-b500-9f61de8a8b8b%2C8f2a3e45-1c9d-4b3a-a7f1-9e8d7c6b5a4f&data_inicio=2026-01-01&data_fim=2026-12-31' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK - Retorna a lista paginada de transferências entre contas financeiras

Bodyapplication/json

itens_totaisinteger, (int64)

Número total de transferências encontradas

Example:50

itensArray of objects(TransferenciaContaFinanceira)

Lista de transferências entre contas financeiras

Response

{
  "itens_totais": 2,
  "itens": [
    { … },
    { … }
  ]
}