Wortic

Wortic CNPJ / Guias

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

CampoO que é
tipo1 pessoa jurídica, 2 pessoa física, 3 estrangeiro
documentoPara pessoa física, 11 asteriscos: a API não mostra nenhum dígito do CPF.
qualificacaoO papel na empresa, como Sócio-Administrador, com o código da Receita
desdeA data em que a pessoa entrou na sociedade
faixa_etariaA 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