> ## 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 lista de vínculos

> Após a autorização do trabalhador, este serviço permite consultar os vínculos empregatícios do CPF informado. A consulta retorna os vínculos disponíveis para análise da operação, incluindo informações de elegibilidade, matrícula e identificação do empregador.

Este endpoint possui processamento síncrono e retorna a lista de vínculos encontrados para o CPF consultado. Após identificar um vínculo elegível, utilize o endpoint de consulta de dados do vínculo para obter informações detalhadas necessárias para análise e formalização da operação.

<Info>
  Apenas vínculos elegíveis devem ser utilizados nas etapas seguintes de consulta de dados para formalização da operação.
</Info>

<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="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>

  <Accordion title="Descrição dos campos do response">
    <ResponseField name="CodigoRequisicao" type="string">
      Código identificador da requisição feita.
    </ResponseField>

    <ResponseField name="Origem" type="string">
      Identificador do endpoint onde foi feita a requisição.
    </ResponseField>

    <ResponseField name="Conteudo" type="object">
      Objeto com o resultado da consulta de vínculos.
    </ResponseField>

    <ResponseField name="vinculos" type="object[]">
      Lista de vínculos de trabalho do CPF consultado.
    </ResponseField>

    <ResponseField name="vinculos.cpf" type="number">
      CPF do vínculo do trabalhador.
    </ResponseField>

    <ResponseField name="vinculos.matricula" type="string">
      Matrícula do trabalhador junto ao empregador.
    </ResponseField>

    <ResponseField name="vinculos.inscricaoEmpregador.codigo" type="number">
      Código do tipo de inscrição do empregador (1 - CNPJ, 2 - CPF).
    </ResponseField>

    <ResponseField name="vinculos.inscricaoEmpregador.descricao" type="string">
      Descrição do tipo de inscrição do empregador.
    </ResponseField>

    <ResponseField name="vinculos.numeroInscricaoEmpregador" type="string">
      Número de inscrição do empregador.
    </ResponseField>

    <ResponseField name="vinculos.elegivel" type="boolean">
      Indica se o trabalhador é elegível para contratação naquele momento.
    </ResponseField>

    <ResponseField name="vinculos.motivoInelegibilidade.codigo" type="number">
      1. Empréstimo legado registrado no eSocial
      2. Empréstimo legado informado pela instituição financeira
      3. Valor de remuneração zerado
      4. Vínculo com data de desligamento
      5. Sem remuneração na última competência
      6. Regime trabalhista inválido
      7. Categoria do trabalhador inválida
    </ResponseField>

    <ResponseField name="vinculos.motivoInelegibilidade.descricao" type="string">
      Indica se o vínculo está elegível para contratação de empréstimo consignado.
    </ResponseField>

    <ResponseField name="vinculos.bloqueadoEmprestimo" type="boolean">
      Indica se o vínculo possui bloqueio para contratação de empréstimo consignado.
    </ResponseField>
  </Accordion>
</AccordionGroup>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "CodigoRequisicao": "string",
    "Origem": "/trabalhador/listar-vinculos",
    "Conteudo": {
      "vinculos": [
        {
          "cpf": 12345678911,
          "matricula": "string",
          "inscricaoEmpregador": {
            "codigo": 0,
            "descricao": "string"
          },
          "numeroInscricaoEmpregador": "string",
          "elegivel": true,
          "motivoInelegibilidade": {
            "codigo": 0,
            "descricao": "string"
          },
          "bloqueadoEmprestimo": true
        }
      ]
    }
  }
  ```

  ```json Não autorizado theme={null}
  {
  	"CodigoRequisicao": "ead960cf-4f60-44b8-9ca4-ebc1ced1a5e0",
  	"Origem": "listar-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": "2ca1c2ae-08bc-4be7-8f88-0574507830ae",
  			"Campo": null
  		}
  	]
  }
  ```
</ResponseExample>