Consulta Operações de Crédito

O endpoint GET /banking/originator/applications permite consultar operações de crédito (CCBs) utilizando diversos filtros de busca.

A rota suporta combinação de filtros para facilitar consultas específicas ou listagens amplas de operações.


Query Parameters Disponíveis

ParâmetroTipoDescrição
idsList UUIDLista de IDs das operações
borrower_idUUIDID do tomador
product_idUUIDID do produto
sequential_idLongNúmero da operação
borrower_employer_idUUIDID do empregador do tomador
funding_idUUIDID do funding vinculado à operação
statusList ApplicationStatusStatus da operação
cession_statusList ApplicationCessionStatusStatus de cessão da operação
cession_idUUIDID da cessão vinculada
external_idStringIdentificador externo da operação informado pelo cliente
created_date_fromDate (yyyy-MM-dd)Data inicial do filtro de criação da operação
created_date_toDate (yyyy-MM-dd)Data final do filtro de criação da operação
disbursement_date_fromDate (yyyy-MM-dd)Data inicial do filtro de desembolso
disbursement_date_toDate (yyyy-MM-dd)Data fim do filtro de desembolso
disbursement_processed_date_fromDate (yyyy-MM-dd)Data inicial do desembolso efetivado
disbursement_processed_date_toDate (yyyy-MM-dd)Data final do desembolso efetivado
taxpayer_idStringCPF/CNPJ do tomador


Regras Gerais de Utilização


Filtros com múltiplos valores

Os parâmetros abaixo aceitam múltiplos valores:

  • ids
  • status
  • cession_status

Para utilizá-los, repita o parâmetro na query string:

curl -X GET "https://api.flowfinance.com.br/banking/originator/applications?\
page=0&size=50&\
status=PENDING_DISBURSEMENT&status=ISSUED&\
borrower_id=550e8400-e29b-41d4-a716-446655440000&\
product_id=6ba7b810-9dad-11d1-80b4-00c04fd430c8&\
funding_id=7c9e6679-7425-40de-944b-e07fc1f90ae7&\
cession_status=CEDED&\
cession_id=8a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9&\
sequential_id=1234&\
ids=11111111-1111-1111-1111-111111111111&\
ids=22222222-2222-2222-2222-222222222222&\
external_id=EXT-00099&\
created_date_from=2026-01-01&created_date_to=2026-04-15&\
disbursement_date_from=2026-02-01&disbursement_date_to=2026-03-31" \
  -H "Authorization: Bearer <JWT>" \
  -H "Accept: application/json"


Filtros de Data

Todos os filtros de data devem seguir o formato:

yyyy-MM-dd

Exemplos de Uso


Consultar por ID Externo

GET /banking/originator/applications?external_id=pedido-123

Consultar por Status

GET /banking/originator/applications?status=PENDING_GUARANTEE

Consultar por Período de Criação

GET /banking/originator/applications?created_date_from=2026-04-01&created_date_to=2026-04-15

Boas Práticas de Consulta

  • Sempre prefira filtros específicos (external_id, borrower_id, taxpayer_id) para consultas pontuais.
  • Para listagens amplas, utilize filtros de data para reduzir o volume retornado.
  • Combine múltiplos filtros para refinar os resultados.

Observações

  • Todos os filtros são opcionais.
  • Quando nenhum filtro é informado, a rota retorna todas as operações disponíveis para o originador autenticado.