Ler os sócios e entender a máscara do CPF
A rota de sócios traz nome, qualificação, data de entrada e faixa etária. O CPF de quem é pessoa física nunca sai inteiro: vem só a máscara.
Publicado em .
Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.
A rota é GET /cnpj/{cnpj}/socios. Ela serve para saber quem responde pela empresa, por exemplo para endereçar uma proposta à pessoa certa.
A resposta
{"itens":[{
"tipo": {"codigo":"2","descricao":"Pessoa física"},
"nome": "NOME DO SÓCIO",
"documento": "***********",
"qualificacao": {"codigo":"49","descricao":"Sócio-Administrador"},
"desde": "2026-09-04",
"faixa_etaria": {"codigo":"4","descricao":"31 a 40 anos"}
}],"total":1}
Neste guia o nome foi trocado por NOME DO SÓCIO; a API devolve o nome como a Receita publica.
O que cada campo diz
| Campo | O que é |
|---|---|
tipo | 1 pessoa jurídica, 2 pessoa física, 3 estrangeiro |
documento | Para pessoa física, 11 asteriscos: a API não mostra nenhum dígito do CPF. |
qualificacao | O papel na empresa, como Sócio-Administrador, com o código da Receita |
desde | A data em que a pessoa entrou na sociedade |
faixa_etaria | A faixa de idade publicada pela Receita, não a idade |
O código
const r = await fetch("https://cnpj.wortic.com/cnpj/37853407000171/socios");
const { itens } = await r.json();
const quemAssina = itens.filter((s) => /administrador/i.test(s.qualificacao.descricao));
for (const s of quemAssina) console.log(s.nome, "-", s.qualificacao.descricao);
O nome do sócio é dado público do cadastro. Use para o que a pessoa espera, como chamar o responsável pelo nome, e trate como dado pessoal no seu sistema.
Perguntas e respostas
Por que o CPF do sócio vem só com asteriscos?
Porque a API nunca mostra o CPF de sócio pessoa física, nem em parte: o campo documento vem com 11 asteriscos. Os dados abertos da Receita trazem 6 dígitos do meio; a API não repassa nenhum.
Dá para descobrir a idade do sócio?
Não a idade exata. A API traz a faixa etária que a Receita publica, como "31 a 40 anos".
Como saber se o sócio é uma pessoa ou outra empresa?
Pelo campo tipo: código 1 é pessoa jurídica, 2 é pessoa física e 3 é estrangeiro.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA