Consultar empréstimo

Devolve a situação completa de um contrato na Dataprev: dados da averbação, histórico de saldo devedor, pagamentos, escriturações e o kit do contrato enviado.

Endpoint: POST /econsigado/loans/contract-inquiries
Scope: econsignado.read
Equivalente na Dataprev: /emprestimos/consultar-emprestimo-trabalhador

Aqui não se envia a identificação do vínculo: a Dataprev localiza o empréstimo pelo número do contrato somado ao código da instituição.

curl --location 'https://secureapi.onz.finance/api/v2/econsigado/loans/contract-inquiries' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "contract_number": "CTR0001"
  }'

Campo	Obrigatório	Descrição
contract_number	Sim	Contrato averbado por esta conta

Resposta

{
  "data": {
    "contrato": "CTR0001",
    "nomeTrabalhador": "Nome do Trabalhador",
    "nomeEmpregador": "Razão Social do Empregador",
    "dataInicioContrato": "21082026",
    "dataFimContrato": "05022027",
    "competenciaInicioDesconto": 202610,
    "competenciaFimDesconto": 202703,
    "totalParcelas": 6,
    "valorParcela": 354.54,
    "valorEmprestimo": 2000,
    "valorLiberado": 1984.5,
    "situacaoEmprestimo": { "codigo": 0, "descricao": "Ativo" },
    "origemAverbacao": { "codigo": 0, "descricao": "Averbação banco" },
    "garantia": { "temGarantias": false },
    "saldosDevedor": [
      { "dataHoraInclusao": "2026-08-21T16:34:22", "valorSaldoDevedor": 1772.7 },
      { "dataHoraInclusao": "2026-08-21T16:15:27", "valorSaldoDevedor": 2127.24 }
    ],
    "pagamentos": [],
    "escrituracoes": [],
    "informacoesContrato": {
      "arquivosEnviados": [
        { "tipoArquivo": 2, "descricao": "Contrato" },
        { "tipoArquivo": 5, "descricao": "Registro Biométrico Facial" }
      ],
      "baseBiometrica": "SERPRO",
      "score": 98.5,
      "dataHoraAssinatura": "21082026161500",
      "indicadorValidacaoComDocOficial": false
    },
    "qtdPagamentos": 0,
    "qtdEscrituracoes": 0
  }
}

O saldosDevedor[] vem em ordem decrescente de inclusão, então o primeiro item é o saldo mais recente.

Erros relevantes

HTTP	Situação
403	Conta sem a liberação de empréstimo consignado
404	Contrato não averbado nesta plataforma ou de outra conta

A consulta exige o contrato averbado por esta conta, o que impede uma conta de consultar contrato de outra. Contratos que existam na Dataprev mas não nesta plataforma não são consultáveis por aqui.