Consultar contratos migrados para o e-consignado

GET/v1/emprestimos/migracoes

🔒 Requer Bearer token

Escopo emprestimos:read. Lista os contratos do parceiro MIGRADOS para o e-consignado no período informado — consulta ao vivo no Dataprev (via Socinal), com a paginação do upstream já percorrida. Proxy filtrado por contrato + CPF: só retorna contratos do próprio parceiro, e um contrato migrado cujo número não exista no parceiro não aparece. Use contrato para restringir a uma CCB e cpf para estreitar a consulta. Sem registros retorna { "migracoes": [] }.

Parâmetros

contratostringqueryopcional

Número da CCB (contrato) do parceiro. Quando informado, a consulta é restrita a este contrato; se o contrato não pertencer ao parceiro, retorna 404.

cpfstringqueryopcional

CPF do trabalhador (11 dígitos, sem máscara). Estreita a consulta no Dataprev; o resultado continua restrito aos contratos do parceiro.

padrão: ^\d{11}$

data_iniciostringqueryopcional

Início da janela de busca (YYYY-MM-DD). Default: janela padrão do backend.

padrão: ^\d{4}-\d{2}-\d{2}$

data_fimstringqueryopcional

Fim da janela de busca (YYYY-MM-DD). Default: hoje.

padrão: ^\d{4}-\d{2}-\d{2}$

Respostas

Corpo da resposta 200

migracoesarray<object>obrigatório

contratostringobrigatório

cpf_trabalhadorstringobrigatório

matriculastringobrigatórionullable

if_concessoraobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

inscricao_empregadorobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

numero_inscricao_empregadorstringobrigatório

cnpj_empregador_completobooleanobrigatório

nome_trabalhadorstringobrigatório

nome_empregadorstringobrigatório

data_inicio_contratostring<date>obrigatório

data_fim_contratostring<date>obrigatório

competencia_inicio_descontostringobrigatório

competencia_fim_descontostringobrigatório

total_parcelasintegerobrigatório

valor_parcelanumberobrigatório

valor_emprestimonumberobrigatório

valor_liberadonumberobrigatório

valor_iofnumberobrigatório

valor_taxa_mensalnumberobrigatório

valor_taxa_anualnumberobrigatório

valor_cet_mensalnumberobrigatório

valor_cet_anualnumberobrigatório

situacao_emprestimoobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

origem_averbacaoobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

origem_exclusaoobjectobrigatórionullable

codigointegerobrigatório

descricaostringobrigatório

situacao_bloqueio_garantiaobjectobrigatórionullable

codigointegerobrigatório

descricaostringobrigatório

data_inclusao_emprestimostring<date-time>obrigatório

data_atualizacaostring<date-time>obrigatório

data_exclusaostring<date-time>obrigatórionullable

data_envio_info_contratostring<date-time>obrigatório

garantiaobjectobrigatórionullable

tem_garantiasbooleanobrigatório

valor_saldo_disponivel_garantia_fgtsnumberobrigatório

valor_multa_rescisoria_garantia_fgtsnumberobrigatório

perc_verba_rescisoria_garantianumberobrigatório

Request

curl -X GET 'https://econsignado-api.socinal.com.br/v1/emprestimos/migracoes?contrato=valor&cpf=valor&data_inicio=valor&data_fim=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "migracoes": [
    {
      "contrato": "A100001-001",
      "cpf_trabalhador": "75842274574",
      "matricula": "MAT-8024716378",
      "if_concessora": {
        "codigo": 425,
        "descricao": "Socinal SA"
      },
      "inscricao_empregador": {
        "codigo": 1,
        "descricao": "CNPJ"
      },
      "numero_inscricao_empregador": "12674953000114",
      "cnpj_empregador_completo": true,
      "nome_trabalhador": "João da Silva",
      "nome_empregador": "Alves Teixeira - EI",
      "data_inicio_contrato": "2024-01-01",
      "data_fim_contrato": "2026-01-01",
      "competencia_inicio_desconto": "202601",
      "competencia_fim_desconto": "202602",
      "total_parcelas": 24,
      "valor_parcela": 150.55,
      "valor_emprestimo": 3000,
      "valor_liberado": 2950,
      "valor_iof": 33.73,
      "valor_taxa_mensal": 2.5,
      "valor_taxa_anual": 34.49,
      "valor_cet_mensal": 2.9,
      "valor_cet_anual": 40.9,
      "situacao_emprestimo": {
        "codigo": 15,
        "descricao": "Encerrado por término do vínculo"
      },
      "origem_averbacao": {
        "codigo": 1,
        "descricao": "CNPJ"
      },
      "origem_exclusao": {
        "codigo": 1,
        "descricao": "CNPJ"
      },
      "situacao_bloqueio_garantia": {
        "codigo": 1,
        "descricao": "CNPJ"
      },
      "data_inclusao_emprestimo": "2026-05-22T17:30:00.000Z",
      "data_atualizacao": "2026-05-22T17:30:00.000Z",
      "data_exclusao": "2026-05-22T17:30:00.000Z",
      "data_envio_info_contrato": "2026-05-22T17:30:00.000Z",
      "garantia": {
        "tem_garantias": true,
        "valor_saldo_disponivel_garantia_fgts": 98587.56,
        "valor_multa_rescisoria_garantia_fgts": 5500.45,
        "perc_verba_rescisoria_garantia": 25
      }
    }
  ]
}