Background Check PJ

Este endpoint monta um dossiê completo de uma empresa a partir do CNPJ: cadastro na Receita Federal, endereço, CNAEs, quadro societário, funcionários, saúde tributária, regime do Simples, sanções administrativas, processos judiciais, veículos e imóveis.

É a maior resposta da API. Para a consulta enxuta do quadro societário, use o QSA; para a inscrição estadual, o Sintegra.

🚧 O corpo é repassado do provedor, sem transformação

Diferente dos outros endpoints de dados, aqui a API não remonta a resposta: o que o provedor devolve é entregue como está, dentro do envelope padrão. Três consequências práticas:

• Os nomes dos campos estão em português, no vocabulário do provedor (razaoSocial, situacaoCadastral, socios), com alguns blocos em inglês (activityLevelV2, tributaryHealth), e não no camelCase em inglês do resto da API.
• Todo bloco é opcional. Um bloco só aparece quando o provedor tem dado para ele. Nunca assuma que uma chave existe: teste antes de acessar.
• Não há garantia de tipo. Como não há conversão no caminho, o mesmo campo pode chegar como número ou como texto conforme a origem do dado. Por isso as tabelas desta página descrevem os campos, mas não fixam tipos.

Request

GET /background-check/v2/legal-entity/{CNPJ}

Parâmetros

Parâmetro	Descrição	Obrigatório
CNPJ	CNPJ da empresa consultada	Sim

O CNPJ pode ser enviado com ou sem máscara (12.345.678/0001-95 ou 12345678000195), sempre com os 14 caracteres. Um CNPJ que não passa na validação do dígito verificador devolve 422 antes de qualquer consulta.

CNPJ alfanumérico

O endpoint aceita o CNPJ alfanumérico definido pela IN RFB 2.229/2024, em que as oito primeiras posições da raiz e as quatro da ordem podem conter letras, e os dois dígitos verificadores continuam numéricos.

GET /background-check/v2/legal-entity/12ABC34501DE35

Maiúsculas, minúsculas e máscara dão no mesmo

A API normaliza o CNPJ antes de consultar: tira a máscara e converte as letras para maiúsculas. 12abc34501de35, 12ABC34501DE35 e 12.ABC.345/01DE-35 são a mesma consulta.

Headers

Authorization: ApiKey <sua-chave-de-api>

Parâmetros de query são ignorados

Este endpoint não usa parâmetros de query. Um parâmetro desconhecido na URL não gera erro: ele é simplesmente ignorado, e a resposta vem 200 normalmente.

Exemplo Request

curl -i 'https://api.nxcd.app/background-check/v2/legal-entity/12345678000195' \
  --header 'Authorization: ApiKey SUA_CHAVE_AQUI'

Response

O envelope é o padrão da API:

Campo	Descrição	Tipo
id	Identificador único da requisição	String
version	Versão da API que atendeu a chamada	String
data	O dossiê. Vem vazio ({}) quando o CNPJ não é encontrado.	Object
metadata	Metadados da requisição	Object
metadata.timeSpent	Tempo de processamento da requisição, em milissegundos	Number

O data é montado com os blocos abaixo. Nenhum deles é garantido — cada um aparece só quando há dado.

Bloco	O que traz
Cadastro	CNPJ, razão social, natureza jurídica, porte, situação cadastral
Endereço e contato	Endereço completo e telefones
Atividade econômica	CNAE principal, demais CNAEs, nível de atividade
Porte e faturamento	Capital social, faixa de faturamento presumido
Matriz e coligadas	Dados da matriz, número de filiais, empresas coligadas
Quadro societário	Sócios pela Receita Federal e pela Junta Comercial
Funcionários	Funcionários, ex-funcionários e evolução do quadro
Situação fiscal	Saúde tributária, Simples Nacional, Sintegra, dívidas na PGFN/DAU
Sanções e listas restritivas	CEIS, CNEP, Banco Central, MTE
Processos judiciais	Totalizadores por tipo e processos do CNJ/CNIA
Patrimônio	Imóveis e frota de veículos
Programas e registros	PAT e programas de computador no INPI
_metadata	Data e fonte de cada bloco

Cadastro

Campo	Descrição
empresa.cnpj	CNPJ da empresa
empresa.razaoSocial	Razão social
empresa.nomeFantasia	Nome fantasia
empresa.porte	Porte da empresa, por exemplo ME
empresa.matriz	Indica se o CNPJ consultado é o da matriz
empresa.naturezaJuridica.codigo	Código da natureza jurídica
empresa.naturezaJuridica.descricao	Descrição da natureza jurídica
empresa.situacaoCadastral.status	Situação cadastral na Receita Federal, por exemplo ATIVA
empresa.situacaoCadastral.motivo	Motivo da situação cadastral
empresa.situacaoCadastral.data	Data em que a situação passou a valer
empresa.situacaoEspecial.status	Situação especial, quando houver
empresa.situacaoEspecial.data	Data da situação especial
natureza.classificacao	Classificação da natureza, por exemplo PRIVADO
info.idadeEmpresa	Idade da empresa, em anos

{
  "empresa": {
    "cnpj": "12345678000195",
    "razaoSocial": "EMPRESA EXEMPLO LTDA",
    "nomeFantasia": "EXEMPLO",
    "porte": "ME",
    "matriz": true,
    "naturezaJuridica": { "codigo": "2062", "descricao": "SOCIEDADE EMPRESARIA LIMITADA" },
    "situacaoCadastral": { "status": "ATIVA", "data": "2017-09-26T00:00:00Z" }
  },
  "natureza": { "classificacao": "PRIVADO" },
  "info": { "idadeEmpresa": 8 }
}

Endereço e contato

bairroOriginal e municipioOriginal trazem o texto como veio da fonte; bairro e municipio trazem a versão normalizada pelo provedor.

Campo	Descrição
endereco.logradouro	Logradouro
endereco.numero	Número
endereco.complemento	Complemento
endereco.bairro	Bairro, normalizado
endereco.bairroOriginal	Bairro como veio da fonte
endereco.municipio	Município, normalizado
endereco.municipioOriginal	Município como veio da fonte
endereco.mesoRegiao	Mesorregião
endereco.uf	Unidade federativa
endereco.cep	CEP
endereco.precisao	Precisão da localização, por exemplo REGIAO
endereco.enderecoResidencial	Indica se o endereço declarado é residencial
telefones[].numero	Número do telefone
telefones[].fonteInformacao	Fonte de onde o telefone veio
info.possuiEmailContador	Indica se o e-mail cadastrado é o do contador

{
  "endereco": {
    "logradouro": "RUA SAO BENTO",
    "numero": "101010",
    "complemento": "ANDAR 2",
    "bairro": "CENTRO",
    "bairroOriginal": "CENTRO",
    "municipio": "SAO PAULO",
    "municipioOriginal": "SAO PAULO",
    "mesoRegiao": "METROPOLITANA DE SAO PAULO",
    "uf": "SP",
    "cep": "01010000",
    "precisao": "REGIAO",
    "enderecoResidencial": false
  },
  "telefones": [{ "numero": "1133334444" }]
}

Atividade econômica

Campo	Descrição
cnaePrincipal.codigo	Código do CNAE principal
cnaePrincipal.descricao	Descrição do CNAE principal
cnaes[].codigo	Código de cada CNAE secundário
cnaes[].descricao	Descrição de cada CNAE secundário
activityLevelV2.activityLevel	Nível de atividade estimado pelo provedor, por exemplo MEDIO

{
  "cnaePrincipal": {
    "codigo": "6311900",
    "descricao": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET"
  },
  "cnaes": [
    {
      "codigo": "6311900",
      "descricao": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET"
    }
  ],
  "activityLevelV2": { "activityLevel": "MEDIO" }
}

Porte e faturamento

Campo	Descrição
potencialConsumo.valorCapitalSocial	Capital social da empresa
faturamentoPresumido.faixaIndividual	Faixa de faturamento presumido da empresa
faturamentoPresumido.faixaGrupo	Faixa de faturamento presumido do grupo econômico
totalFuncionarios.quantidade	Total de funcionários da empresa
totalFuncionarios.quantidadeGrupo	Total de funcionários do grupo econômico

🚧 São faixas, não valores

faturamentoPresumido traz apenas as faixas — textos como DE R$ 360.000,01 A R$ 1.500.000,00. Não há campo com o valor numérico estimado do faturamento.

{
  "potencialConsumo": { "valorCapitalSocial": 10000 },
  "faturamentoPresumido": {
    "faixaIndividual": "DE R$ 360.000,01 A R$ 1.500.000,00",
    "faixaGrupo": "DE R$ 360.000,01 A R$ 1.500.000,00"
  },
  "totalFuncionarios": { "quantidade": 1, "quantidadeGrupo": 1 }
}

Matriz e coligadas

Quando o CNPJ consultado é o de uma filial, matriz descreve a matriz correspondente. Quando é o da matriz, matriz.quantidadeFilial conta as filiais.

Campo	Descrição
matriz.cnpj	CNPJ da matriz
matriz.razaoSocial	Razão social da matriz
matriz.situacao	Situação cadastral da matriz
matriz.dataAbertura	Data de abertura da matriz
matriz.municipio	Município da matriz
matriz.quantidadeFilial	Número de filiais
empresasColigadas[].cnae	CNAE de cada empresa coligada

Quadro societário

São duas listas, com a mesma estrutura e fontes diferentes: socios vem do quadro societário da Receita Federal e sociosJunta, da Junta Comercial. Divergência entre as duas é justamente o que info.qsaDivergente sinaliza.

Campo	Descrição
socios[].nome	Nome do sócio
socios[].documento	CPF ou CNPJ do sócio
socios[].qualificacao	Qualificação, por exemplo SOCIO ADMINISTRADOR
socios[].participacaoSocietaria	Participação societária do sócio
socios[].falecido	Indica registro de falecimento do sócio
socios[].nivelPep	Nível de exposição política do sócio
socios[].paisOrigem	País de origem do sócio
sociosJunta[]	Mesmos campos, exceto paisOrigem
info.qsaDivergente	Indica divergência entre o quadro societário das duas fontes

paisOrigem só existe em socios

A lista sociosJunta traz os mesmos seis campos restantes, mas não traz paisOrigem. Um código que percorre as duas listas com a mesma função precisa tolerar a ausência.

{
  "socios": [
    {
      "nome": "JOAO DA SILVA",
      "documento": "12345678909",
      "qualificacao": "SOCIO ADMINISTRADOR",
      "participacaoSocietaria": 0,
      "falecido": false,
      "nivelPep": "NAO IDENTIFICADO"
    }
  ],
  "sociosJunta": [
    {
      "nome": "JOAO DA SILVA",
      "documento": "12345678909",
      "qualificacao": "SOCIO ADMINISTRADOR",
      "participacaoSocietaria": 0,
      "falecido": false,
      "nivelPep": "NAO IDENTIFICADO"
    }
  ],
  "info": { "qsaDivergente": false }
}

Funcionários

‼️ Este bloco traz CPF e nome de pessoas físicas

funcionarios e exfuncionarios trazem dado pessoal de terceiros. Trate-os com o mesmo cuidado de qualquer consulta de pessoa física: colete só o necessário, não repasse adiante e observe a base legal do seu tratamento.

Campo	Descrição
funcionarios[].cpf	CPF do funcionário
funcionarios[].nome	Nome do funcionário
funcionarios[].dataNascimento	Data de nascimento
funcionarios[].dataAdmissao	Data de admissão
exfuncionarios[].cpf	CPF do ex-funcionário
exfuncionarios[].nome	Nome do ex-funcionário
exfuncionarios[].dataNascimento	Data de nascimento
exfuncionarios[].dataAdmissao	Data de admissão
exfuncionarios[].anoMesDesligamento	Mês e ano do desligamento, por exemplo 06-2019
calc.totalExFuncionarios.porAno[].ano	Ano
calc.totalExFuncionarios.porAno[].quantidade	Ex-funcionários naquele ano
crescimentoPorAnoRais[].ano	Ano de referência na RAIS
crescimentoPorAnoRais[].qtdFuncionarios	Funcionários naquele ano
crescimentoPorAnoRais[].percentual	Variação percentual em relação ao ano anterior

{
  "crescimentoPorAnoRais": [
    { "ano": 2019, "qtdFuncionarios": 1, "percentual": -66.67 },
    { "ano": 2018, "qtdFuncionarios": 3, "percentual": 100 }
  ],
  "calc": {
    "totalExFuncionarios": {
      "porAno": [{ "ano": 2019, "quantidade": 4 }]
    }
  }
}

Situação fiscal

Campo	Descrição
tributaryHealth.saudeTributaria	Classificação de saúde tributária, por exemplo CINZA
tributaryHealth.cnds[].nome	Nome da certidão negativa de débitos
tributaryHealth.cnds[].descricaoSituacao	Situação da certidão
tributaryHealth.cnds[].numeroCertificacao	Número da certidão
tributaryHealth.cnds[].dataEmissao	Data de emissão
tributaryHealth.cnds[].dataValidade	Data de validade
simplesNacional.optanteSimples	Indica opção pelo Simples Nacional
simplesNacional.optanteSimei	Indica opção pelo SIMEI
simplesNacional.simplesIrregular	Indica irregularidade no Simples Nacional
info.passivelIss	Indica se a empresa é passível de ISS
info.valorDividaPgfnDau	Valor total da dívida inscrita na PGFN/DAU
debitosPgfnDau[].inscricao	Número da inscrição em dívida ativa da União
debitosPgfnDau[].natureza	Natureza do débito
debitosPgfnDau[].valorTotal	Valor total do débito
debitosPgfnDau[].dataProcessamento	Data de processamento
sintegra.inscricaoEstadual	Inscrição estadual
sintegra.uf	UF da inscrição
sintegra.situacaoCadastral	Situação cadastral no Sintegra
sintegra.dataSituacaoCadastral	Data da situação cadastral
sintegra.regimeApuracao	Regime de apuração
empresaSintegra.inscricoes[].ie	Inscrição estadual
empresaSintegra.inscricoes[].uf	UF da inscrição
empresaSintegra.inscricoes[].situacaoCadastral	Situação cadastral
empresaSintegra.inscricoes[].dataSituacaoCadastral	Data da situação cadastral
empresaSintegra.inscricoes[].regimeApuracao	Regime de apuração
empresaSintegra.inscricoes[].email	E-mail da inscrição
empresaSintegra.inscricoes[].telefone.telefone	Telefone da inscrição

sintegra e empresaSintegra cobrem o mesmo assunto

sintegra traz uma inscrição estadual; empresaSintegra.inscricoes[] traz a lista, com um item por UF em que a empresa tem inscrição. Para uma empresa com inscrição em mais de um estado, é empresaSintegra que dá o quadro completo.

{
  "tributaryHealth": { "saudeTributaria": "CINZA", "cnds": [] },
  "simplesNacional": {
    "optanteSimples": true,
    "optanteSimei": false,
    "simplesIrregular": false
  },
  "info": { "passivelIss": true, "valorDividaPgfnDau": 0 }
}

Sanções e listas restritivas

São blocos independentes, um por cadastro de origem. Cada um aparece só quando há registro.

empresaCeis — Cadastro de Empresas Inidôneas e Suspensas.

Campo	Descrição
empresaCeis.sancoes[].processo	Número do processo
empresaCeis.sancoes[].tipoSancao	Tipo da sanção
empresaCeis.sancoes[].periodoSancao.inicio	Início do período da sanção
empresaCeis.sancoes[].periodoSancao.final	Fim do período da sanção
empresaCeis.sancoes[].fundamentacaoLegal	Fundamentação legal
empresaCeis.sancoes[].orgaoSancionador	Órgão que aplicou a sanção
empresaCeis.sancoes[].complementoOrgao	Complemento do órgão sancionador
empresaCeis.sancoes[].uf	UF
empresaCeis.sancoes[].origemInformacao	Origem da informação
empresaCeis.sancoes[].dataInformacao	Data da informação

cnep — Cadastro Nacional de Empresas Punidas.

Campo	Descrição
cnep.processos[].numeroProcesso	Número do processo
cnep.processos[].tipoSancao	Tipo da sanção
cnep.processos[].valorMulta	Valor da multa
cnep.processos[].dataInicioSancao	Início da sanção
cnep.processos[].dataFinalSancao	Fim da sanção
cnep.processos[].orgaoSancionador	Órgão que aplicou a sanção
cnep.processos[].ufOrgaoSancionador	UF do órgão sancionador

bancoCentral — acórdãos do Banco Central.

Campo	Descrição
bancoCentral.acordaos[].numeroRecurso	Número do recurso
bancoCentral.acordaos[].numeroProcesso	Número do processo
bancoCentral.acordaos[].numeroAcordaoCRSFN	Número do acórdão no CRSFN
bancoCentral.acordaos[].recurso	Identificação do recurso
bancoCentral.acordaos[].parte	Parte envolvida no acórdão

Na PJ não há bloco de inabilitados

No Background Check PF, bancoCentral traz também inabilitados[]. Aqui só há acordaos[].

mteCnd e mteTrabalhoEscravo — Ministério do Trabalho.

Campo	Descrição
mteCnd.tipoCertidao	Tipo da certidão
mteCnd.situacaoDebito	Situação do débito trabalhista
mteCnd.codigo	Código da certidão
mteCnd.dataEmissao	Data de emissão
mteCnd.processos[].numero	Número do processo
mteCnd.processos[].situacaoProcesso	Situação do processo
mteCnd.processos[].categoriaInfracao	Categoria da infração
mteCnd.processos[].capitulacaoInfracao	Capitulação legal da infração
mteTrabalhoEscravo.estabelecimentos[].anoAcaoFiscal	Ano da ação fiscal
mteTrabalhoEscravo.estabelecimentos[].dataDecisaoProcedencia	Data da decisão de procedência
mteTrabalhoEscravo.estabelecimentos[].numeroTrabalhadoresEnvolvidos	Trabalhadores envolvidos
mteTrabalhoEscravo.estabelecimentos[].estabelecimento	Endereço do estabelecimento, com logradouro, complemento, municipio e uf

mteCnd.situacaoDebito existe só na PJ; no Background Check PF o bloco mteCnd não traz esse campo.

Processos judiciais

processoJudicialTotalizadores traz duas visões: quantidades[], com uma linha por tipo de processo, e os valores totais na raiz do bloco.

Campo	Descrição
processoJudicialTotalizadores.quantidades[].tipo	Tipo de processo a que as contagens se referem
processoJudicialTotalizadores.quantidades[].qtdTotal	Total de processos daquele tipo
processoJudicialTotalizadores.quantidades[].qtdAtivos	Processos ainda em andamento
processoJudicialTotalizadores.quantidades[].qtdParteAtiva	Processos em que a empresa é o polo ativo
processoJudicialTotalizadores.quantidades[].qtdPartePassiva	Processos em que a empresa é o polo passivo
processoJudicialTotalizadores.quantidades[].qtdOutrasPartes	Processos em que a empresa figura em outra posição
processoJudicialTotalizadores.valorTotal	Valor total envolvido
processoJudicialTotalizadores.valorTotalAtiva	Valor total em que a empresa é o polo ativo
processoJudicialTotalizadores.valorTotalPassiva	Valor total em que a empresa é o polo passivo
processoJudicialTotalizadores.valorTotalOutrasPartes	Valor total nas demais posições
cnjCnia.processos[].numeroProcesso	Número do processo no CNJ/CNIA
cnjCnia.processos[].dataCadastramento	Data de cadastramento
cnjCnia.processos[].esfera	Esfera do processo
cnjCnia.processos[].descricaoOrgao	Órgão julgador
cnjCnia.processos[].cargoFuncao.uf	UF do cargo ou função relacionada ao processo
cnjCnia.processos[].assuntosRelacionados	Assuntos relacionados ao processo
cnjCnia.processos[].ressarcimentoIntegralDano.valor	Valor de ressarcimento integral do dano

Os valores totais só existem na PJ

Os quatro campos valorTotal* são exclusivos deste endpoint. No Background Check PF, processoJudicialTotalizadores traz apenas quantidades[].

{
  "processoJudicialTotalizadores": {
    "valorTotal": 0,
    "valorTotalAtiva": 0,
    "valorTotalPassiva": 0,
    "valorTotalOutrasPartes": 0
  }
}

Patrimônio

Campo	Descrição
imoveis[].imovelId	Identificador do imóvel
imoveis[].areaTerreno	Área do terreno
imoveis[].areaConstruida	Área construída
imoveis[].valorAvaliacao	Valor de avaliação
imoveis[].logradouro	Logradouro do imóvel
imoveis[].numeroLogradouro	Número
imoveis[].complemento	Complemento
imoveis[].bairro	Bairro
imoveis[].municipio	Município
imoveis[].uf	Unidade federativa
imoveis[].cep	CEP
detran.totalVeiculosPesados	Veículos pesados da empresa
detran.totalVeiculosPesadosGrupo	Veículos pesados do grupo econômico
totalVeiculos.ateUmAno	Veículos com até um ano
totalVeiculos.entreDoisCincoAnos	Veículos entre dois e cinco anos
totalVeiculos.entreCincoDezAnos	Veículos entre cinco e dez anos
totalVeiculos.acimaDezAnos	Veículos com mais de dez anos
totalVeiculos.grupoAteUmAno	Mesma faixa, no grupo econômico
totalVeiculos.grupoEntreDoisCincoAnos	Mesma faixa, no grupo econômico
totalVeiculos.grupoEntreCincoDezAnos	Mesma faixa, no grupo econômico
totalVeiculos.grupoAcimaDezAnos	Mesma faixa, no grupo econômico

🚧 As faixas de totalVeiculos não cobrem tudo

As faixas vão de "até um ano" direto para "entre dois e cinco anos". Veículos com idade entre um e dois anos não estão em nenhuma delas, e somar as quatro faixas não devolve necessariamente a frota total.

Programas e registros

Campo	Descrição
novoPat.modalidades[].descricao	Modalidade do Programa de Alimentação do Trabalhador
novoPat.modalidades[].numeroTrabBeneficiados	Trabalhadores beneficiados
novoPat.modalidades[].razaoSocialForcenedor	Razão social do fornecedor
novoPat.modalidades[].cnpjForcenedor	CNPJ do fornecedor
empresaInpiProgramas.processos[].titulo	Título do programa de computador registrado no INPI
empresaInpiProgramas.processos[].numeroProcesso	Número do processo no INPI
empresaInpiProgramas.processos[].dataDeposito	Data de depósito
empresaInpiProgramas.processos[].procurador	Procurador responsável
empresaInpiProgramas.processos[].autores[].autor	Autores do programa

🚧 razaoSocialForcenedor e cnpjForcenedor estão escritos assim mesmo

Os dois campos de fornecedor em novoPat.modalidades[] vêm com Forcenedor, e não Fornecedor. É o nome real do campo na resposta — escrever o nome correto devolve undefined.

_metadata

Fora do metadata do envelope, o próprio data traz um _metadata com a procedência de cada bloco: quando o dado foi coletado, de que fonte veio, e se a busca não encontrou nada.

As chaves de _metadata são os nomes internos das fontes (empresa, empresas, socios, sociosJunta, funcionarios, exfuncionarios, calc, empresa-ceis, empresa-cnep, empresa-banco-central, empresa-mte-trabalho-escravo, datascience-tributary-health…), e variam com os blocos que vieram preenchidos. Cada uma traz alguns destes campos:

Campo	Descrição
noMatchFound	true quando a fonte foi consultada e não encontrou registro
source	Lista com as fontes de origem do dado
processingTimestamp	Quando a fonte processou o dado
lastUpdate	Última atualização do dado na base do provedor
insertDate	Quando o dado entrou na base do provedor
updatedAt	Quando o registro foi atualizado pela última vez

noMatchFound é a diferença entre "não tem" e "não foi consultado"

Um bloco ausente do data pode significar duas coisas. Se a fonte correspondente aparece em _metadata com noMatchFound: true, a consulta foi feita e nada foi encontrado — um resultado limpo. Se a fonte não aparece em _metadata, não há essa garantia.

{
  "_metadata": {
    "empresa": {
      "insertDate": "2025-10-05T16:41:45.974Z",
      "lastUpdate": "2025-10-05T16:32:25Z",
      "processingTimestamp": "2025-10-05T16:32:25Z",
      "source": ["rf-pj"],
      "updatedAt": "2025-10-05T16:41:51.718Z"
    },
    "socios": {
      "lastUpdate": "2025-10-10T14:14:39.657Z",
      "processingTimestamp": "2025-08-18T03:00:00Z",
      "source": ["QSA RF PPD2"],
      "updatedAt": "2025-10-10T18:53:20.837Z"
    },
    "sociosJunta": {
      "lastUpdate": "2025-10-10T14:14:39.678Z",
      "source": ["JUCESP"],
      "updatedAt": "2025-10-10T14:39:22.63Z"
    },
    "empresa-ceis": { "noMatchFound": true },
    "empresa-cnep": { "noMatchFound": true },
    "empresa-banco-central": { "noMatchFound": true },
    "empresa-mte-trabalho-escravo": { "noMatchFound": true }
  }
}

Exemplo completo

Uma resposta com os blocos mais comuns preenchidos. Os blocos sem dado simplesmente não aparecem — em uma consulta real, esperar todos eles é o erro mais frequente de integração.

Status Code: 200

{
  "id": "13cfec7c-b238-4820-a4d1-5173e4c1418e",
  "version": "v2",
  "data": {
    "_metadata": {
      "empresa": {
        "lastUpdate": "2025-10-05T16:32:25Z",
        "source": ["rf-pj"],
        "updatedAt": "2025-10-05T16:41:51.718Z"
      },
      "empresa-ceis": { "noMatchFound": true },
      "empresa-cnep": { "noMatchFound": true },
      "empresa-banco-central": { "noMatchFound": true },
      "empresa-mte-trabalho-escravo": { "noMatchFound": true }
    },
    "empresa": {
      "cnpj": "12345678000195",
      "razaoSocial": "EMPRESA EXEMPLO LTDA",
      "nomeFantasia": "EXEMPLO",
      "porte": "ME",
      "matriz": true,
      "naturezaJuridica": { "codigo": "2062", "descricao": "SOCIEDADE EMPRESARIA LIMITADA" },
      "situacaoCadastral": { "status": "ATIVA", "data": "2017-09-26T00:00:00Z" }
    },
    "natureza": { "classificacao": "PRIVADO" },
    "info": {
      "idadeEmpresa": 8,
      "passivelIss": true,
      "possuiEmailContador": false,
      "qsaDivergente": false,
      "valorDividaPgfnDau": 0
    },
    "matriz": { "quantidadeFilial": 0 },
    "endereco": {
      "logradouro": "RUA SAO BENTO",
      "numero": "101010",
      "complemento": "ANDAR 2",
      "bairro": "CENTRO",
      "municipio": "SAO PAULO",
      "uf": "SP",
      "cep": "01010000",
      "precisao": "REGIAO",
      "enderecoResidencial": false
    },
    "telefones": [{ "numero": "1133334444" }],
    "cnaePrincipal": {
      "codigo": "6311900",
      "descricao": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET"
    },
    "cnaes": [
      {
        "codigo": "6311900",
        "descricao": "TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET"
      }
    ],
    "activityLevelV2": { "activityLevel": "MEDIO" },
    "potencialConsumo": { "valorCapitalSocial": 10000 },
    "faturamentoPresumido": {
      "faixaIndividual": "DE R$ 360.000,01 A R$ 1.500.000,00",
      "faixaGrupo": "DE R$ 360.000,01 A R$ 1.500.000,00"
    },
    "totalFuncionarios": { "quantidade": 1, "quantidadeGrupo": 1 },
    "socios": [
      {
        "nome": "JOAO DA SILVA",
        "documento": "12345678909",
        "qualificacao": "SOCIO ADMINISTRADOR",
        "participacaoSocietaria": 0,
        "falecido": false,
        "nivelPep": "NAO IDENTIFICADO"
      }
    ],
    "crescimentoPorAnoRais": [
      { "ano": 2019, "qtdFuncionarios": 1, "percentual": -66.67 },
      { "ano": 2018, "qtdFuncionarios": 3, "percentual": 100 }
    ],
    "simplesNacional": {
      "optanteSimples": true,
      "optanteSimei": false,
      "simplesIrregular": false
    },
    "tributaryHealth": { "saudeTributaria": "CINZA", "cnds": [] },
    "detran": { "totalVeiculosPesados": 0, "totalVeiculosPesadosGrupo": 0 },
    "totalVeiculos": {
      "ateUmAno": 0,
      "entreDoisCincoAnos": 0,
      "entreCincoDezAnos": 0,
      "acimaDezAnos": 0,
      "grupoAteUmAno": 0,
      "grupoEntreDoisCincoAnos": 0,
      "grupoEntreCincoDezAnos": 0,
      "grupoAcimaDezAnos": 0
    },
    "processoJudicialTotalizadores": {
      "valorTotal": 0,
      "valorTotalAtiva": 0,
      "valorTotalPassiva": 0,
      "valorTotalOutrasPartes": 0
    }
  },
  "metadata": {
    "timeSpent": 5800
  }
}

Quando o CNPJ não é encontrado

O data vem vazio. A resposta continua sendo 200.

Status Code: 200

{
  "id": "13cfec7c-b238-4820-a4d1-5173e4c1418e",
  "version": "v2",
  "data": {},
  "metadata": {
    "timeSpent": 1300
  }
}

Headers de resposta

Header	Quando aparece
Nextid-ReqId	Em todas as respostas. Traz o identificador da requisição, o mesmo do campo id do corpo.

Erros

Código	Quando ocorre
401 Unauthorized	Chave de API ausente, inválida, ou sem a permissão nextid.bureaus.backgroundCheckCompany.
404 Not Found	A versão informada na URL não existe. Só v2 é aceita.
422 Unprocessable Entity	CNPJ que não passa na validação do dígito verificador.
500 Internal Server Error	Falha inesperada durante o processamento.

Exemplo de resposta com CNPJ inválido:

Status Code: 422

{
  "id": "13cfec7c-b238-4820-a4d1-5173e4c1418e",
  "error": {
    "statusCode": 422,
    "error": "Unprocessable Entity",
    "message": "Invalid Legal Entities National Register"
  }
}

O formato das respostas de erro está descrito em Códigos HTTP das respostas.

Versões

A única versão é a v2, e ela é a que atende quando a versão é omitida na URL. /background-check/legal-entity/{CNPJ} e /background-check/v2/legal-entity/{CNPJ} são equivalentes.

Versão	Situação	O que muda
v2	Recomendada	Única versão. É o que responde quando a versão é omitida na URL.

Qualquer outro valor no lugar de v2 devolve 404.

Endpoint relacionado

Para o dossiê de uma pessoa física, veja o Background Check PF.