# Retornar as transferências entre contas financeiras por filtro

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.

Endpoint: GET /v1/financeiro/transferencias
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Query parameters:

  - `pagina` (integer)
    Número da página para paginação dos resultados

  - `tamanho_pagina` (integer)
    Quantidade de itens por página

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

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

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

## Response 200:

  - `200` (unknown)
    OK - Retorna a lista paginada de transferências entre contas financeiras

## Response 200 fields (application/json):

  - `itens_totais` (integer)
    Número total de transferências encontradas
    Example: 50

  - `itens` (array)
    Lista de transferências entre contas financeiras

  - `itens.id` (string)
    Identificador único da transferência
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `itens.descricao` (string)
    Descrição ou motivo da transferência
    Example: Transferência para conta poupança

  - `itens.valor` (number)
    Valor da transferência
    Example: 1500.5

  - `itens.data` (string)
    Data em que a transferência foi realizada (formato ISO date)
    Example: 2026-02-15

  - `itens.origem` (object)
    Informações de quitação de uma conta financeira incluindo data, composição de valores e detalhes da conta

  - `itens.origem.data` (string)
    Data da quitação (formato ISO date)
    Example: 2026-02-15

  - `itens.origem.composicao_valor` (object)
    Composição detalhada do valor de uma transação financeira

  - `itens.origem.composicao_valor.valor_bruto` (number)
    Valor bruto da transação antes de qualquer ajuste
    Example: 1500.5

  - `itens.origem.composicao_valor.juros` (number)
    Valor de juros aplicado
    Example: 0

  - `itens.origem.composicao_valor.multa` (number)
    Valor de multa aplicado
    Example: 0

  - `itens.origem.composicao_valor.valor_liquido` (number)
    Valor líquido após todos os ajustes (valor_bruto + juros + multa - desconto - taxa)
    Example: 1500.5

  - `itens.origem.composicao_valor.desconto` (number)
    Valor de desconto aplicado
    Example: 0

  - `itens.origem.composicao_valor.taxa` (number)
    Valor de taxa aplicado
    Example: 0

  - `itens.origem.conta_financeira` (object)
    Detalhes de uma conta financeira

  - `itens.origem.conta_financeira.id` (string)
    Identificador único da conta financeira
    Example: 8f2a3e45-1c9d-4b3a-a7f1-9e8d7c6b5a4f

  - `itens.origem.conta_financeira.nome` (string)
    Nome da conta financeira
    Example: Conta Corrente Principal

  - `itens.origem.conta_financeira.instituicao_bancaria` (object)
    Informações da instituição bancária

  - `itens.origem.conta_financeira.instituicao_bancaria.codigo` (integer)
    Código da instituição bancária
    Example: 1

  - `itens.origem.conta_financeira.instituicao_bancaria.nome` (string)
    Nome da instituição bancária
    Example: Banco do Brasil

## Response 400:

  - `400` (unknown)
    Bad Request - Parâmetros inválidos na requisição

## Response 400 fields (application/json):

  - `code` (integer)
    Example: 400

  - `message` (string)
    Example: A data de início não pode ser posterior à data de fim.

## Response 401:

  - `401` (unknown)
    Unauthorized - Token de autenticação inválido ou expirado

## Response 401 fields (application/json):

  - `code` (integer)
    Example: 401

  - `message` (string)
    Example: The Token has expired.

## Response 429:

  - `429` (unknown)
    Too Many Requests - Limite de requisições excedido

## Response 500:

  - `500` (unknown)
    Internal Server Error - Erro interno no servidor

## Response 500 fields (application/json):

  - `code` (integer)
    Example: 500

  - `message` (string)
    Example: Ocorreu um erro inesperado no servidor. Tente novamente mais tarde.

## Response 200 examples:

  - `Exemplo de resposta com transferências` (unknown)

  - `Exemplo de resposta sem transferências` (unknown)

## Response 400 examples:

  - `Erro de validação de datas` (unknown)

  - `Erro de UUID inválido` (unknown)