Skip to main content
🤖 As consultas de Dados Cadastrais retornam um objeto base comum chamado entity. Dependendo se a consulta foi feita por um CPF ou CNPJ, a propriedade entity_type retornará "person" ou "company", respectivamente. Alguns campos, como parents (filiação) ou share_capital (capital social), são exclusivos do seu respectivo tipo de entidade.

​
Estrutura Base (Comum a CPF e CNPJ)

Sempre que você consultar um documento válido, a Judit API retornará o bloco entity contendo as seguintes propriedades universais:

​
Identificação Principal

PropriedadeTipoDescrição
entity_idstringIdentificador único interno da entidade no sistema da Judit.
entity_typestringTipo da entidade: "person" (Pessoa Física) ou "company" (Empresa).
main_documentstringDocumento principal (CPF ou CNPJ). Retornado apenas com números.
namestringNome civil completo da pessoa ou Razão Social oficial da empresa.
aka_namesarrayLista de nomes alternativos (apelidos, nomes de solteiro ou Nomes Fantasia).
nationalitystringNacionalidade da pessoa ou país de registro da empresa.
revenue_service_activebooleanIndica se o documento está regular e ativo na base da Receita Federal.
created_at / updated_atstringDatas (ISO 8601) de criação e última atualização do registro no sistema.
tagsobjectMetadados extras ou de controle do Crawler (ex: data da extração na Receita).

​
Arrays de Contato e Localização

Todas as entidades (Pessoas ou Empresas) possuem arrays padronizados para contato e endereços.

​
Endereços (addresses)

Lista de endereços residenciais ou comerciais vinculados ao documento.
PropriedadeTipoDescrição
streetstringLogradouro principal (Rua, Avenida, etc.).
numberstringNúmero do imóvel predial.
complementstringComplemento (apto, bloco, sala, andar).
neighborhoodstringBairro de localização.
citystringCidade do endereço.
statestringUnidade Federativa (UF) do endereço (ex: "SP", "RJ").
countrystringPaís de localização.
zip_codestringCódigo Postal / CEP. Retornado apenas com números.
ibge_codenumberCódigo oficial do município na tabela do IBGE.

​
Contatos (contacts)

Lista de meios de comunicação extraídos das bases de dados.
PropriedadeTipoDescrição
contact_typestringCategoria do contato (ex: "phone", "email").
descriptionstringO valor do contato em si (o número de telefone ou o endereço de e-mail).

​
Outros Documentos (documents)

Lista de documentos de identificação secundários (como RG, CNH, Inscrição Estadual).
PropriedadeTipoDescrição
document_typestringTipo do documento secundário (ex: "RG", "IE").
documentstringO número do documento sem formatação.

​
👤 Propriedades Exclusivas: Pessoa Física (person)

Se a consulta for de um CPF (entity_type: "person"), o objeto poderá conter as seguintes propriedades e arrays adicionais:
PropriedadeTipoDescrição
birth_datestringData de nascimento. Formato ISO 8601.
genderstringGênero/sexo cadastrado (ex: "M", "F").
parentsarrayArray de filiação. Cada item contém name (nome completo) e kinship (grau de parentesco, ex: "mother", "father").
partnersarrayLista de cônjuges ou companheiros identificados.
associated_peoplearrayLista de outras pessoas físicas com vínculos identificáveis (sociedade, residência conjunta).

​
🏢 Propriedades Exclusivas: Empresa (company)

Se a consulta for de um CNPJ (entity_type: "company"), o objeto poderá conter os seguintes campos societários e de operação adicionais:

​
Dados Operacionais

PropriedadeTipoDescrição
social_namestringNome Fantasia (nome de mercado da empresa).
birth_datestringData oficial de abertura/fundação da empresa na Receita Federal.
sizestringPorte cadastral oficial (ex: "ME", "EPP", "DEMAIS").
head_officebooleanIndica se o CNPJ em questão é a Matriz (true) ou uma Filial (false).
special_statusstringSituação especial perante o fisco (ex: Recuperação Judicial, Concordata).
share_capitalnumberValor do capital social declarado em formato numérico.
parentsarrayLista de empresas que atuam como matriz, controladoras ou holdings (Grupo Econômico).

​
Estrutura Societária e Econômica

PropriedadeTipoDescrição
codestringCódigo numérico oficial da natureza (ex: "206-2").
namestringDescrição por extenso (ex: "Sociedade Empresária Limitada").
activebooleanIndica se este é o enquadramento atual vigente.

​
Quadro de Sócios e Administradores - QSA (partners)

PropriedadeTipoDescrição
namestringNome do sócio ou administrador.
main_documentstringCPF ou CNPJ do participante societário.
positionstringQualificação/Cargo ocupado (ex: "SÓCIO-ADMINISTRADOR", "DIRETOR").
entity_typestringTipo da entidade sócia ("person" ou "company").

​
Atividades Econômicas - CNAE (branch_activities)

PropriedadeTipoDescrição
codestringCódigo CNAE da atividade.
namestringTítulo ou descrição por extenso da atividade.
main_activitybooleanIndica se é o CNAE Principal (true) ou CNAE Secundário (false).

​
Exemplo de Payload (Pessoa Jurídica)

{
   "has_lawsuits": false,
   "request_id": "5c618521-2ecc-4176-a573-431d2e0edeb2",
   "response_data": [
       {
           "entity_id": "",
           "entity_type": "person",
           "main_document": "999.999.999-99",
           "name": "JOÃO TESTE",
           "addresses": [
               {
                   "street": "RUA RAMOS DE CARVALHO",
                   "number": "999",
                   "complement": "",
                   "neighborhood": "CENTRO",
                   "city": "RIO DE JANEIRO",
                   "state": "RJ",
                   "country": "Brasil",
                   "zip_code": "99999999",
                   "ibge_code": 9999999
               }
           ],
           "aka_names": [],
           "contacts": [
               {
                   "description": "21999999999",
                   "contact_type": "phone"
               }
           ],
           "documents": [],
           "parents": [
               {
                   "name": "JANAINA DA SILVA",
                   "kinship": "mother"
               }
           ],
           "partners": [],
           "associated_people": [],
           "tags": {
               "revenue_update_date": "2022-05-30T00:00:00.000Z"
           },
           "created_at": "2024-10-12T13:28:59.051Z",
           "updated_at": "2024-10-12T13:28:59.051Z",
           "nationality": "BRASILEIRA",
           "birth_date": "1981-08-07T00:00:00.000Z",
           "gender": "male",
           "revenue_service_active": true
       }
   ]
}

​
Próximos Passos

Agora que você entende o dicionário de dados cadastrais, veja como consultar essas informações:
  • 👉 Consultas Cadastrais: Veja a documentação da rota de requisição para buscar e enriquecer CPFs e CNPJs em tempo real.