> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta de dados de vínculo

> Este serviço permite consultar os dados detalhados de um vínculo empregatício do trabalhador. São retornadas informações utilizadas na análise e formalização da operação, como elegibilidade do vínculo, margem disponível e dados trabalhistas.

As informações retornadas podem ser utilizadas para análise de crédito, elegibilidade do vínculo e formalização da operação. Os dados do vínculo devem ser obtidos previamente através do endpoint de consulta de lista de vínculos.

<AccordionGroup>
  <Accordion title="Descrição dos campos da requisição">
    <ParamField path="cpfTrabalhador" type="string" required>
      CPF do trabalhador a ser consultado.
    </ParamField>

    <ParamField path="matricula" type="string" required>
      Matrícula do trabalhador junto ao empregador.
    </ParamField>

    <ParamField path="codigoInscricaoEmpregador" type="number" required>
      Código do tipo de inscrição do empregador (1 - CNPJ, 2 - CPF).
    </ParamField>

    <ParamField path="numeroInscricaoEmpregador" type="string" required>
      Número de inscrição do empregador.
    </ParamField>

    <ParamField path="consultaCacheada" type="bool">
      Indica se a consulta deve utilizar dados em cache. Quando `true`, os dados são obtidos do cache da BMP (validade de 24 horas). Quando `false`, a consulta é realizada diretamente na DATAPREV. Caso não informado, o valor padrão será `false`.
    </ParamField>
  </Accordion>
</AccordionGroup>

<RequestExample>
  ```shellscript Exemplo de requisição theme={null}
  curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/consultar-vinculos' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "cpfTrabalhador": "string",
    "matricula": "string",
    "codigoInscricaoEmpregador": 0,
    "numeroInscricaoEmpregador": "string",
    "consultaCacheada": false
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "CodigoRequisicao": "string",
    "Origem": "string",
    "Conteudo": {
      "cpf": 12345678911,
      "matricula": "string",
      "inscricaoEmpregador": {
        "codigo": 0,
        "descricao": "string"
      },
      "numeroInscricaoEmpregador": "string",
      "nome": "string",
      "sexo": {
        "codigo": 0,
        "descricao": "string"
      },
      "dataNascimento": "ddMMyyyy",
      "codigoCategoriaTrabalhador": 0,
      "elegivel": true,
      "motivoInelegibilidade": {
        "codigo": 0,
        "descricao": "string"
      },
      "valorTotalVencimentos": 0,
      "valorBaseMargem": 0,
      "valorMargemDisponivel": 0,
      "dataAdmissao": "ddMMyyyy",
      "dataDesligamento": "ddMMyyyy",
      "codigoMotivoDesligamento": 0,
      "pessoaExpostaPoliticamente": {
        "codigo": 0,
        "descricao": "string"
      },
      "nomeEmpregador": "string",
      "nomeMae": "string",
      "paisNacionalidade": {
        "codigo": 0,
        "descricao": "string"
      },
      "cbo": {
        "codigo": 0,
        "descricao": "string"
      },
      "cnae": {
        "codigo": 0,
        "descricao": "string"
      },
      "dataInicioAtividadeEmpregador": "ddMMyyyy",
      "qtdEmprestimosAtivosSuspensos": 2,
      "tipoBloqueio": {
        "codigo": 0,
        "descricao": "string"
      },
      "dataHoraBloqueio": "ddMMyyyyhhmmss",
      "percentualVerbaRescisoriaDisponivel": 23,
      "alertas": [
        {
          "tipoAlerta": {
            "codigo": 0,
            "descricao": "string"
          },
          "dataReferencia": "ddMMyyyy",
          "idEvento": 0,
          "codigoMotivoAfastamento": 0,
          "dataAfastamento": "ddMMyyyy",
          "dataTerminoAfastamento": "ddMMyyyy",
          "codigoMotivoDesligamento": 0,
          "dataDesligamento": "ddMMyyyy",
          "dataAvisoPrevio": "ddMMyyyy",
          "dataFimAvisoPrevio": "ddMMyyyy"
        }
      ],
      "emprestimosLegados": [
        {
          "codigoIF": 0,
          "contrato": "string",
          "dataInicioContrato": "ddMMyyyy",
          "dataFimContrato": "ddMMyyyy",
          "totalParcelas": 0,
          "valorParcela": 0,
          "valorEmprestimo": 0,
          "valorLiberado": 0,
          "dataHoraAtualizacao": "ddMMyyyyhhmmss",
          "valorTaxaMensal": 0,
          "valorCETMensal": 0,
          "tipoContrato": {
            "codigo": 0,
            "descricao": "string"
          },
          "qtdParcelasPagas": 0,
          "valorSaldoDevedor": 0
        }
      ]
    }
  }
  ```

  ```json Não autorizado theme={null}
  {
  	"CodigoRequisicao": "5dd1e690-8ffa-4423-89eb-f93f14842e83",
  	"Origem": "consultar-vinculos",
  	"Conteudo": null,
  	"Erros": [
  		{
  			"Codigo": "CON_403",
  			"Message": "CPF não possui autorização de consulta de dados válida. Coletar assinatura do termo e enviar para /trabalhador/termo-autorizacao antes de executar a consulta.",
  			"Id": "96dc3265-52cf-4de8-b68b-9601e00b0e7b",
  			"Campo": null
  		}
  	]
  }
  ```
</ResponseExample>