Background Check PJ

Relatório completo de uma empresa: cadastro, sócios, grupo econômico, processos, score de crédito e restrições, com PDF.

Entrada: CNPJAssíncrona (requestId)

Gerar chave de API

Quando usar

Homologação de fornecedores

Um relatório único para aprovar ou reprovar um fornecedor.

Crédito PJ

Score, restrições e processos na mesma resposta.

M&A e parcerias

Grupo econômico e sócios para entender com quem você está lidando.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

1POSTCriar relatório
Envia o documento e recebe o requestId na hora.
2GETAcompanhar
Repete a chamada com o requestId enquanto o status for pending.
3GETBuscar relatório
Com status done, o resultado completo vem em data.

Precisa estar habilitado

A consulta company_background_check precisa ser habilitada para a sua conta. Fale com o suporte para liberar.

PDF pronto para arquivar

Com o mesmo requestId, o endpoint /pdf devolve o relatório em PDF, sem nova cobrança.

Sem cobrança em caso de falha

Se a consulta terminar com erro, o valor volta para o saldo automaticamente.

Passo 1

Criar relatório

POST/api/partner/v2/company/background-check

Cria uma consulta assíncrona de Background Check PJ. A resposta contém um requestId; use-o no endpoint de resultado até receber o status done ou error.

O relatório reúne dados cadastrais, indicadores de atividade, CNAEs, contatos, endereços, sócios, grupo econômico, processos judiciais, score de crédito e dados restritivos. Se algum conjunto de dados estiver indisponível, seu estado será indicado em data.sections.

Cada chamada cria uma nova consulta, mesmo quando o CNPJ já foi consultado, e o consumo segue a configuração comercial da conta do cliente. A feature company_background_check deve estar habilitada. Falhas do provedor são reembolsadas automaticamente.

Corpo da requisição

documentstringobrigatório
CNPJ válido. Pontuação é aceita e removida antes da consulta.

Respostas

200Solicitação criada com sucesso
400CNPJ inválido
401Token ausente ou inválido
402Consulta não habilitada ou saldo insuficiente
500Erro interno ao iniciar a consulta

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/company/background-check" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"document":"12345678000195"}'

Resposta · 200

{
  "requestId": "cm8p1q2r30004ab12cdef5678",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar relatório

GET/api/partner/v2/company/background-check/{requestId}

Consulte este endpoint periodicamente com o requestId recebido no POST. Enquanto o processamento estiver em andamento, o status será pending ou running. Pare as tentativas quando receber done ou error. Quando concluído, o campo data contém o relatório completo.

Parâmetros do caminho

requestIdstringno caminhoobrigatório
ID retornado ao criar a consulta

Respostas

200Estado atual ou resultado da solicitação
400Request ID inválido
401Token ausente ou inválido
403A solicitação pertence a outro usuário
404Solicitação não encontrada
500Erro interno ao recuperar o resultado

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/company/background-check/cm8p1q2r30004ab12cdef5678" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "data": {
    "reportType": "complete",
    "cnpj": "12345678000190",
    "generatedAt": "2026-10-06T14:32:10.512Z",
    "basic": {
      "officialName": "EMPRESA EXEMPLO COMERCIO LTDA",
      "tradeName": "EXEMPLO PEÇAS",
      "taxIdNumber": "12345678000190",
      "legalNatureCode": "2062",
      "legalNatureDescription": "SOCIEDADE EMPRESARIA LIMITADA",
      "foundedDate": "2008-04-15T00:00:00Z",
      "taxIdStatus": "ATIVA",
      "taxIdStatusDate": "2008-04-15T00:00:00Z",
      "isHeadquarter": true,
      "capital": "CINQUENTA MIL REAIS",
      "capitalRS": "50000.00"
    },
    "activity": {
      "employeesRange": "010 A 019",
      "incomeRange": "ACIMA DE 1MM ATE 2.5MM",
      "numberOfBranches": 1,
      "companySize": null,
      "activityLevel": 0.25,
      "shellCompanyLikelyhood": 0.5
    },
    "cnae": [
      {
        "code": "4530703",
        "activity": "COMERCIO A VAREJO DE PECAS E ACESSORIOS NOVOS PARA VEICULOS AUTOMOTORES",
        "isMain": true
      },
      {
        "code": "4520001",
        "activity": "SERVICOS DE MANUTENCAO E REPARACAO MECANICA DE VEICULOS AUTOMOTORES",
        "isMain": false
      }
    ],
    "emails": [
      {
        "email": "contato@empresaexemplo.com.br",
        "type": "CORPORATE",
        "isActive": true,
        "validationStatus": "VALID",
        "lastUpdateDate": "2026-07-22T00:00:00Z"
      }
    ],
    "phones": [
      {
        "number": "33334444",
        "areaCode": "11",
        "type": "WORK",
        "lastUpdateDate": "2026-07-22T00:00:00Z"
      },
      {
        "number": "999998888",
        "areaCode": "11",
        "type": "MOBILE",
        "lastUpdateDate": "2026-05-10T00:00:00Z"
      }
    ],
    "addresses": [
      {
        "logradouro": "R DAS FLORES",
        "number": "120",
        "complement": "SALA 2",
        "neighborhood": "CENTRO",
        "zipCode": "01001000",
        "city": "SAO PAULO",
        "state": "SP",
        "type": "OFFICIAL REGISTRATION"
      }
    ],
    "partners": [
      {
        "name": "MARIA OLIVEIRA COSTA",
        "document": "12345678901",
        "documentType": "CPF",
        "role": "SOCIO-ADMINISTRADOR",
        "level": "1st-LEVEL",
        "startDate": "2008-04-15T00:00:00Z"
      }
    ],
    "economicGroup": [
      {
        "name": "EXEMPLO PARTICIPACOES LTDA",
        "document": "98765432000110",
        "documentType": "CNPJ",
        "role": "SOCIO-ADMINISTRADOR",
        "level": "2nd-LEVEL",
        "startDate": "2015-09-01T00:00:00Z"
      }
    ],
    "lawsuits": {
      "total": 13,
      "asAuthor": 4,
      "asDefendant": 8,
      "asOther": 1,
      "last30": 0,
      "last90": 1,
      "last180": 2,
      "last365": 3,
      "byNature": {
        "civel": 7,
        "fiscal": 3,
        "trabalhista": 2,
        "criminal": 0,
        "outros": 1
      },
      "natureIsSample": false
    }
  },
  "status": "done"
}

Passo 3

Baixar PDF

GET/api/partner/v2/company/background-check/{requestId}/pdf

Gera e baixa o relatório completo em PDF utilizando o mesmo requestId da consulta. Faça o download somente depois que o endpoint de resultado retornar status: done.

O arquivo é renderizado sob demanda e não fica armazenado. O download não cria uma nova consulta nem realiza um novo consumo da conta. É possível baixar novamente utilizando o mesmo requestId.

Parâmetros do caminho

requestIdstringno caminhoobrigatório
ID retornado ao criar a consulta

Respostas

200Arquivo PDF do Background Check
400Request ID inválido
401Token ausente ou inválido
403A solicitação pertence a outro usuário
404Solicitação não encontrada
409O relatório ainda está processando ou terminou com erro
500Erro ao recuperar os dados ou gerar o arquivo PDF

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/company/background-check/cm8p1q2r30004ab12cdef5678/pdf" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

A resposta é o arquivo application/pdf para download.

O que a resposta traz

Cadastro

Razão social e nome fantasia
officialName · tradeName
Natureza jurídica
legalNatureCode · legalNatureDescription
Código e descrição. Ex.: 2062, sociedade empresária limitada.
Situação cadastral e data
taxIdStatus · taxIdStatusDate
Ativa, inapta, baixada, suspensa ou nula.
Data de fundação
foundedDate
Matriz ou filial
isHeadquarter
Capital social
capital · capitalRS
Por extenso e em reais.
CNAEs
cnae[]
Código, atividade e indicação do CNAE principal.

Atividade

Faixa de funcionários
employeesRange
Ex.: 006 A 009, 020 A 049, SEM VINCULOS.
Faixa de faturamento
incomeRange
Ex.: ATE 50K, ACIMA DE 1MM ATE 2.5MM.
Quantidade de filiais
numberOfBranches
Nível de atividade
activityLevel
De 0 a 1. Quanto maior, mais sinais de operação recente.
Probabilidade de empresa de fachada
shellCompanyLikelyhood
De 0 a 1. Quanto maior, mais indícios de empresa sem operação real.

Contatos e endereços

E-mails
emails[]
Corporativo ou pessoal, se está ativo, validação e última atualização.
Telefones
phones[]
DDD, número, tipo (fixo ou celular) e última atualização.
Endereços
addresses[]
Logradouro, número, bairro, CEP, cidade, UF e tipo do endereço.

Sócios e grupo econômico

Quadro societário
partners[]
Nome, CPF/CNPJ, qualificação, nível e data de entrada.
Grupo econômico
economicGroup[]
Empresas e pessoas ligadas por participação ou administração.

Processos judiciais

Total de processos
total
Processos por polo
asAuthor · asDefendant · asOther
Como autora, como ré e em outro papel.
Processos por período
last30 · last90 · last180 · last365
Novos processos nos últimos 30, 90, 180 e 365 dias.
Processos por natureza
byNature
Cível, fiscal, trabalhista, criminal e outros.
Natureza por amostra
natureIsSample
Indica que a divisão por natureza considera só os 100 processos mais recentes.

Score de crédito

Score, faixa e nível de risco
score · scoreRange · riskLevel
Score de 300 a 1000, do risco muito alto ao muito baixo.
Motivos do score
reasons[]
Indicadores de comportamento de crédito
indicators[]
Pagamento em dia, inadimplência, endividamento, busca por crédito e outros, com classificação e interpretação.
Data de referência
referenceDate

Restritivos e endividamento

Negativações ativas e inativas
totalActiveNegativeAppointments · totalInactiveNegativeAppointments
Com a data da última negativação em lastNegativeAppointmentDate.
Protestos
totalRegisteredProtests · totalProtestedAmount
Quantidade e valor total protestado.
Cheques sem fundo
totalBadCheckOccurrences
Endividamento total
totalIndebtednessValue
Ações judiciais de cobrança
totalLawsuitsAppointments · lawsuitsAppointmentsDetails[]
Tipo de ação, autor, justiça, valor e data. Ex.: execução fiscal.
Consultas recentes ao CNPJ
totalInquiriesLast30Days · totalInquiriesBySegment
Por período (30, 60, 90 e mais de 90 dias) e por segmento de quem consultou.
Consultas ao grupo econômico
conglomerateInquiriesData[]
Consultas aos demais CNPJs do conglomerado.

Todos os campos da resposta (87)

statusstring
done
dataobject
Relatório completo da empresa. Campos ou seções podem vir vazios ou nulos quando a fonte não possuir dados. Custos internos dos provedores não são expostos pela API.
data.reportTypestring
complete
data.cnpjstring
CNPJ normalizado, somente com números
data.generatedAtstring
data.basicobject | null
data.basic.officialNamestring
data.basic.tradeNamestring
data.basic.taxIdNumberstring
data.basic.legalNatureCodestring
data.basic.legalNatureDescriptionstring
data.basic.foundedDatestring | null
data.basic.taxIdStatusstring
data.basic.taxIdStatusDatestring | null
data.basic.isHeadquarterboolean
data.basic.capitalstring | null
data.basic.capitalRSstring | null
data.activityobject | null
data.activity.employeesRangestring | null
data.activity.incomeRangestring | null
data.activity.numberOfBranchesinteger | null
data.activity.companySizestring | null
data.activity.activityLevelnumber | null
data.activity.shellCompanyLikelyhoodnumber | null
data.cnaeobject[]
data.cnae[].codestring
data.cnae[].activitystring
data.cnae[].isMainboolean
data.emailsobject[]
data.emails[].emailstring
data.emails[].typestring
data.emails[].isActiveboolean
data.emails[].validationStatusstring | null
data.emails[].lastUpdateDatestring | null
data.phonesobject[]
data.phones[].numberstring
data.phones[].areaCodestring | null
data.phones[].typestring
data.phones[].lastUpdateDatestring | null
data.addressesobject[]
data.addresses[].logradourostring
data.addresses[].numberstring | null
data.addresses[].complementstring | null
data.addresses[].neighborhoodstring | null
data.addresses[].zipCodestring | null
data.addresses[].citystring | null
data.addresses[].statestring | null
data.addresses[].typestring | null
data.partnersobject[]
data.partners[].namestring
data.partners[].documentstring
data.partners[].documentTypestring
data.partners[].rolestring
data.partners[].levelstring | null
data.partners[].startDatestring | null
data.economicGroupobject[]
data.economicGroup[].namestring
data.economicGroup[].documentstring
data.economicGroup[].documentTypestring
data.economicGroup[].rolestring
data.economicGroup[].levelstring | null
data.economicGroup[].startDatestring | null
data.lawsuitsobject | null
Resumo dos processos judiciais associados à empresa
data.lawsuits.totalinteger
data.lawsuits.asAuthorinteger
data.lawsuits.asDefendantinteger
data.lawsuits.asOtherinteger
data.lawsuits.last30integer
data.lawsuits.last90integer
data.lawsuits.last180integer
data.lawsuits.last365integer
data.lawsuits.byNatureobject
data.lawsuits.natureIsSampleboolean
data.quodScoreobject | null
Score de crédito empresarial e seus indicadores
data.quodScore.scorenumber | null
data.quodScore.reasonsstring[]
data.quodScore.riskLevelstring | null
data.quodScore.scoreRangestring | null
data.quodScore.indicatorsobject[]
data.quodScore.referenceDatestring | null
data.quodRestrictiveobject | null
Dados restritivos, incluindo apontamentos negativos, protestos, consultas recentes, cheques e processos informados pela fonte.
data.sectionsobject[]
Disponibilidade de cada conjunto de dados do relatório
data.sections[].datasetstring
data.sections[].labelstring
data.sections[].statusstring
okemptyunavailableerror
data.sections[].billedboolean
data.sections[].messagestring

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.