Listar empréstimos

GET/v1/emprestimos

🔒 Requer Bearer token

Escopo emprestimos:read. **Paginação**: a página tem 20 itens e é escolhida por page (1-based, default 1). O formato da resposta é definido por paginado, e o default é o histórico: (a) **sem paginado** (com ou sem page) a resposta é o **array puro** de empréstimos — nada muda para quem já integra; (b) com **paginado=true** a resposta é um **envelope** { dados: [...], paginacao: { pagina, itens_por_pagina, itens_retornados, tem_proxima_pagina } }. tem_proxima_pagina é true enquanto a página vier cheia (20 itens); a última página de um total múltiplo de 20 devolve true e a página seguinte vem vazia. Cada item traz as duas dimensões de estado do empréstimo: status + proxima_acao (ciclo de vida da CCB) e entrega_docs_dataprev (pendência de entrega de documentos ao Dataprev — null fora do fluxo de entrega diferida).

Parâmetros

statusstringqueryopcional

cpf_trabalhadorstringqueryopcional

numerostringqueryopcional

cnpj_empregadorstringqueryopcional

pagenumberqueryopcional

≥ 1

paginadobooleanqueryopcional

Formato da resposta (não é filtro). Omitido/`false` → array puro de empréstimos, como sempre foi. `true` → envelope `{ dados, paginacao }`. Opt-in explícito justamente para não quebrar quem já itera com `page` e espera um array.

assinatura_socinalbooleanqueryopcional

Respostas

Corpo da resposta 200

idstring<uuid>obrigatório

parceiro_idstring<uuid>obrigatório

numerostringobrigatório

statusstringobrigatório

emitindoem_assinaturaaguardando_averbacaoaverbadadesembolso_agendadodesembolsadaem_atrasoliquidadacanceladarefinanciada

cpf_trabalhadorstringobrigatório

nome_trabalhadorstringobrigatórionullable

estado_civilstringobrigatórionullable

solteirocasadodivorciadoviuvo

cnpj_empregadorstringobrigatórionullable

nome_empregadorstringobrigatórionullable

matriculastringobrigatórionullable

valor_liberadostringobrigatórionullable

prazointegerobrigatórionullable

taxa_mensalstringobrigatórionullable

parcela_valorstringobrigatórionullable

cet_anualstringobrigatórionullable

iofstringobrigatórionullable

total_a_pagarstringobrigatórionullable

saldo_devedorstringobrigatórionullable

parcelas_pagasintegerobrigatório

chave_pixstringobrigatórionullable

data_emissaostring<date-time>obrigatórionullable

data_primeira_parcelastring<date-time>obrigatórionullable

data_liberacaostring<date-time>obrigatórionullable

d4sign_uuidstring<uuid>obrigatórionullable

d4sign_statusstringobrigatórionullable

aguardando_assinaturaassinadoassinado_externo

assinatura_socinalbooleanobrigatório

docs_dataprev_statusstringobrigatórionullable

aguardandoentregue

docs_dataprev_prazostring<date-time>obrigatórionullable

criado_emstring<date-time>obrigatório

atualizado_emstring<date-time>obrigatório

proxima_acaostringobrigatórionullable

aguardar_emissaoenviar_assinaturaregistrar_assinaturainiciar_averbacaoaguardar_validacaodesembolsaraguardar_desembolso

entrega_docs_dataprevobjectobrigatórionullable

statusstringobrigatório

aguardandoentregue

prazostring<date-time>obrigatórionullable

proxima_acaostringobrigatórionullable

aguardar_averbacaoentregar_documentos_dataprev

Request

curl -X GET 'https://econsignado-api.socinal.com.br/v1/emprestimos?status=valor&cpf_trabalhador=valor&numero=valor&cnpj_empregador=valor&page=valor&paginado=valor&assinatura_socinal=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

[
  {
    "id": "24f70ed1-76f3-4604-b341-f2bef2b34d05",
    "parceiro_id": "3f67b7e7-5de9-4a76-b108-d3469b8c6292",
    "numero": "A7565141-000",
    "status": "averbada",
    "cpf_trabalhador": "93871045675",
    "nome_trabalhador": "João da Silva",
    "estado_civil": "solteiro",
    "cnpj_empregador": "12674953000114",
    "nome_empregador": "Alves Teixeira - EI",
    "matricula": "MAT-5646996721",
    "valor_liberado": "1000",
    "prazo": 10,
    "taxa_mensal": "1.79",
    "parcela_valor": "112.07",
    "cet_anual": "23.87",
    "iof": "17.86",
    "total_a_pagar": "1120.7",
    "saldo_devedor": "1120.7",
    "parcelas_pagas": 0,
    "chave_pix": "joao@example.com",
    "data_emissao": "2026-06-10T00:00:00.000Z",
    "data_primeira_parcela": "2026-08-28T00:00:00.000Z",
    "data_liberacao": "2026-06-10T00:00:00.000Z",
    "d4sign_uuid": "e9c02dc2-ab60-4e2f-a401-c263f443282d",
    "d4sign_status": "assinado",
    "assinatura_socinal": true,
    "docs_dataprev_status": null,
    "docs_dataprev_prazo": null,
    "criado_em": "2026-06-03T00:22:05.057Z",
    "atualizado_em": "2026-06-03T00:34:36.084Z",
    "proxima_acao": "desembolsar",
    "entrega_docs_dataprev": null
  },
  {
    "id": "5c1f0a9b-3d42-4a67-9f81-b2e7c4d09a13",
    "parceiro_id": "3f67b7e7-5de9-4a76-b108-d3469b8c6292",
    "numero": "A7565142-000",
    "status": "averbada",
    "cpf_trabalhador": "93871045675",
    "nome_trabalhador": "João da Silva",
    "estado_civil": "solteiro",
    "cnpj_empregador": "12674953000114",
    "nome_empregador": "Alves Teixeira - EI",
    "matricula": "MAT-5646996721",
    "valor_liberado": "1000",
    "prazo": 10,
    "taxa_mensal": "1.79",
    "parcela_valor": "112.07",
    "cet_anual": "23.87",
    "iof": "17.86",
    "total_a_pagar": "1120.7",
    "saldo_devedor": "1120.7",
    "parcelas_pagas": 0,
    "chave_pix": "joao@example.com",
    "data_emissao": "2026-06-10T00:00:00.000Z",
    "data_primeira_parcela": "2026-08-28T00:00:00.000Z",
    "data_liberacao": "2026-06-10T00:00:00.000Z",
    "d4sign_uuid": null,
    "d4sign_status": "assinado_externo",
    "assinatura_socinal": false,
    "docs_dataprev_status": "aguardando",
    "docs_dataprev_prazo": "2026-06-08T00:31:12.500Z",
    "criado_em": "2026-06-03T00:22:05.057Z",
    "atualizado_em": "2026-06-03T00:34:36.084Z",
    "proxima_acao": "desembolsar",
    "entrega_docs_dataprev": {
      "status": "aguardando",
      "prazo": "2026-06-08T00:31:12.500Z",
      "proxima_acao": "entregar_documentos_dataprev"
    }
  }
]