Vínculo Empregatício

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/vinculo-empregaticio

R$ 0,86 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Recupera informações sobre vínculos empregatícios associados a uma empresa mediante a consulta do seu CNPJ. Este endpoint fornece detalhes sobre cada funcionário registrado, incluindo dados pessoais, ocupação profissional (classificação CBO) e histórico de admissão. Ideal para processos de análise de crédito, validação de dados cadastrais, verificação de conformidade e integração com fluxos de onboarding de clientes e fornecedores.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/vinculo-empregaticio?cpf=SEU_CPF&cnpj=SEU_CNPJ"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf opcional	CPF	CPF (somente números, 11 dígitos)	000.000.000-00
cnpj obrigatório	CNPJ	CNPJ (somente números, 14 dígitos)	00.000.000/0000-00

Resposta

A resposta retorna um objeto com os seguintes campos:

cnpj: CNPJ consultado na requisição
razaoSocial: Denominação oficial registrada da empresa
quantidadeFuncionarios: Quantidade total de funcionários vinculados à empresa
funcionarios: Array contendo os registros individuais de cada funcionário:
- cpf: Cadastro de pessoa física do indivíduo
- nome: Denominação completa do funcionário
- dataNascimento: Data de nascimento (formato dd/MM/yyyy)
- codigoCBO: Código de Classificação Brasileira de Ocupações
- descricaoCBO: Descrição textual da ocupação/cargo
- dataAdmissao: Data de entrada na empresa (formato dd/MM/yyyy)

A resposta também inclui metadados sobre a consulta, como timestamp de execução e identificadores únicos da transação.

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ da empresa."
    },
    "consta": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se consta algum registro para o documento consultado."
    },
    "mensagem": {
      "type": [
        "string",
        "null"
      ],
      "description": "Mensagem do resultado da consulta."
    },
    "parametros": {
      "type": [
        "object",
        "null"
      ],
      "description": "Parâmetros informados na consulta."
    },
    "razaoSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social da empresa."
    },
    "funcionarios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "cpf": {
            "type": [
              "string",
              "null"
            ],
            "description": "CPF do funcionário."
          },
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do funcionário."
          },
          "codigoCBO": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código de Classificação Brasileira de Ocupações."
          },
          "dataAdmissao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de admissão do funcionário."
          },
          "descricaoCBO": {
            "type": [
              "string",
              "null"
            ],
            "description": "Descrição da ocupação conforme classificação brasileira."
          },
          "dataNascimento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de nascimento do funcionário."
          }
        }
      },
      "x-display": "table",
      "description": "Lista de funcionários da empresa."
    },
    "quantidadeFuncionarios": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade total de funcionários da empresa."
    }
  }
}

O exemplo de resposta desta consulta é longo demais para caber aqui. A íntegra está na versão em Markdown desta página e na especificação OpenAPI.

Códigos de erro

Código	Mensagem	Quando acontece
400	Requisição Inválida	a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado	o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado	o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado	o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado	o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta	o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção	a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

Validação de dados: Use esta consulta para validar e padronizar informações cadastrais de empresas e seus quadros funcionais antes de processos operacionais.
Análises de crédito e risco: Os dados retornados sobre quantidade, composição e perfil de funcionários são úteis para alimentar modelos de avaliação de risco e concessão de crédito.
Onboarding: Integre este endpoint em fluxos de onboarding de clientes e fornecedores para automatizar verificações de conformidade e validação de estrutura organizacional.
Requisição síncrona: O endpoint processa a consulta de forma síncrona, retornando a resposta completa na mesma chamada.
Autenticação: A requisição requer autenticação padrão do gateway conforme configurado na sua integração.
Atualização de dados: Os dados refletem as informações mais recentes disponíveis na base de referência.

Tempo de resposta aproximado: Varia conforme a quantidade de registros e carga do sistema.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.