Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Devolve a trajetória profissional de uma pessoa física a partir do CPF: onde trabalhou, onde trabalha, desde quando, em que cargo e quanto ganha — estimado. Cada vínculo traz a empresa, o CNPJ, o CNAE da atividade, a natureza do empregador, o período e a renda mensal estimada.
Cobre três situações que costumam exigir consultas separadas: emprego formal (RAIS), sociedade (quadro societário da Receita Federal, para quem é sócio ou empresário) e trabalho informal (revenda e autônomos, via bases privadas de redes de vendas) — este último não aparece em RAIS nem em eSocial.
A renda é estimada a partir das bases de origem, não é renda declarada nem comprovada. Use como indício e ordem de grandeza, nunca como comprovação documental.
{
"type": "object",
"properties": {
"vinculos": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"cnae": {
"type": [
"string",
"null"
],
"description": "Código CNAE da atividade econômica do empregador."
},
"cnpj": {
"type": [
"string",
"null"
],
"format": "cnpj",
"description": "CNPJ da empresa do vínculo, sem máscara."
},
"pais": {
"type": [
"string",
"null"
],
"description": "País do vínculo."
},
"ativo": {
"type": [
"boolean",
"null"
],
"format": "bool",
"description": "Indica se o vínculo está ativo na data da consulta."
},
"fonte": {
"type": [
"string",
"null"
],
"description": "Origem do registro: RAIS, RECEITA FEDERAL ou base privada da rede de vendas."
},
"nivel": {
"type": [
"string",
"null"
],
"description": "Natureza do vínculo: Empregado, Sócio/Empresário, Autônomo ou Revendedor."
},
"renda": {
"type": [
"number",
"null"
],
"format": "currency",
"description": "Renda mensal estimada neste vínculo, em reais. Null quando a fonte não informa."
},
"empresa": {
"type": [
"string",
"null"
],
"description": "Razão social da empresa do vínculo."
},
"data_fim": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Encerramento do vínculo (AAAA-MM-DD). Null quando o vínculo está ativo."
},
"natureza": {
"type": [
"string",
"null"
],
"description": "Natureza do empregador: Privado, Público, Informal ou Misto."
},
"atividade": {
"type": [
"string",
"null"
],
"description": "Descrição da atividade econômica do empregador (CNAE)."
},
"data_inicio": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Início do vínculo (AAAA-MM-DD)."
},
"faixa_renda": {
"type": [
"string",
"null"
],
"description": "Faixa de renda deste vínculo, em salários mínimos. Null quando a fonte não informa."
},
"data_criacao": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Data em que o registro entrou na base de origem (AAAA-MM-DD)."
},
"data_atualizacao": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Última atualização do registro na base de origem (AAAA-MM-DD)."
}
}
},
"x-display": "table",
"description": "Vínculos profissionais da pessoa — empregos formais, sociedades e trabalho informal."
},
"empregado": {
"type": [
"boolean",
"null"
],
"format": "bool",
"description": "Indica se a pessoa possui ao menos um vínculo profissional ativo."
},
"total_vinculos": {
"type": [
"number",
"null"
],
"description": "Total de vínculos profissionais encontrados (ativos e encerrados)."
},
"faixa_renda_total": {
"type": [
"string",
"null"
],
"description": "Faixa da renda total estimada, em salários mínimos. Valores: ATE 2 SM, 2 A 4 SM, 4 A 10 SM, 10 A 20 SM, ACIMA DE 20 SM. Null quando a fonte não informa."
},
"renda_total_estimada": {
"type": [
"number",
"null"
],
"format": "currency",
"description": "Soma estimada, em reais, das rendas dos vínculos ATIVOS. Estimativa a partir de RAIS e Receita Federal — não é renda declarada."
},
"total_vinculos_ativos": {
"type": [
"number",
"null"
],
"description": "Total de vínculos profissionais atualmente ativos."
}
}
}
Códigos de erro
Código
Mensagem
Quando acontece
400
Parâmetros inválidos para esta consulta.
CPF ausente, com dígito verificador inválido ou fora do formato. Máscara é aceita (000.000.000-00).
401
Chave de API ausente ou inválida.
Header X-API-Key não enviado ou não reconhecido.
403
Saldo insuficiente ou acesso negado a este endpoint.
Conta sem saldo para cobrir a consulta ou sem permissão no catálogo da marca.
408
A consulta excedeu o tempo limite. Tente novamente.
A base de origem demorou além do orçamento de tempo da consulta.
451
Dados indisponíveis por solicitação do titular.
O CPF consultado está sob supressão LGPD. A consulta não é cobrada.
500
Erro ao processar a consulta. Tente novamente em instantes.
Falha inesperada ao consultar a base de origem.
Quando usar
Análise de crédito — dimensionar capacidade de pagamento por renda estimada e estabilidade do vínculo (tempo de casa via data_inicio), sem depender de holerite.
Validação de renda declarada — confrontar o que o cliente informou no cadastro com renda_total_estimada, e investigar divergências grandes.
KYC e onboarding — confirmar a ocupação declarada e descobrir sociedades que o cliente não informou (nivel: Sócio/Empresário traz o CNPJ para aprofundar).
Prevenção a fraude — CPF que se declara empregado de uma empresa sem nenhum vínculo com ela na base é sinal de alerta.
Cobrança e recuperação — localizar empregador atual de devedor para orientar a estratégia.
Para o caminho inverso — a partir de um CNPJ, listar os funcionários da empresa com CBO e data de admissão — use o endpoint vinculo-empregaticio.
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.