post
https://api.credify.com.br/backgroundcheckpj
Esta API realiza a consulta completa de Background Check para Pessoa Jurídica (CNPJ). O sistema acessa em tempo real múltiplas fontes de dados, consolidando informações cadastrais, societárias, financeiras e jurídicas da empresa. A resposta retorna dados cadastrais completos, participação societária, score de crédito, analise bureau e relatório jurídico com processos vinculados. É uma ferramenta indispensável para análise de crédito empresarial, due diligence de fornecedores e onboarding corporativo.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
TABELA DE CAMPOS DE REQUISIÇÃO
| Campo | Descrição | Formato | Obrigatório (Sim / Não) |
|---|---|---|---|
| IdConsulta | Identificador único da consulta | string | Sim |
| CNPJ | CNPJ da empresa a ser consultada | string | Sim |
| TipoPessoa | Tipo de pessoa — sempre "J" para Pessoa Jurídica | string | Sim |
TABELA DE CAMPOS DE RETORNO
| Campo | Descrição | Formato |
|---|---|---|
| CONSULTA.CODIGORESPOSTA | Código de resposta da requisição | string |
| CONSULTA.DATAHORA | Data e hora em que a consulta foi realizada | string |
| CONSULTA.LOGON | Código/Logon do usuário que realizou a consulta | string |
| CONSULTA.IDCONSULTA | Identificador único da consulta realizada | string |
| RESPOSTA.CODIGO | Lista de códigos de status de retorno | array de strings |
| RESPOSTA.DADOSCADASTRAIS.CPFCNPJ | Número do CNPJ da empresa consultada | string |
| RESPOSTA.DADOSCADASTRAIS.NOMERAZAO | Razão Social da empresa | string |
| RESPOSTA.DADOSCADASTRAIS.NASCFUND | Data de fundação da empresa | string |
| RESPOSTA.DADOSCADASTRAIS.NOMEFANTASIA | Nome fantasia da empresa | string |
| RESPOSTA.DADOSCADASTRAIS.CODIGONATUREZA | Código da Natureza Jurídica | string |
| RESPOSTA.DADOSCADASTRAIS.DESCNATUREZA | Descrição da Natureza Jurídica | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.TP_LOGRADOURO | Tipo do logradouro do endereço da empresa | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.LOGRADOURO | Nome do logradouro do endereço da empresa | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.NUMERO | Número do endereço | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.COMPLEMENTO | Complemento do endereço | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.BAIRRO | Bairro do endereço | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.CIDADE | Cidade do endereço | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.UF | Unidade Federativa (estado) do endereço | string |
| RESPOSTA.ENDERECOS.REGISTRO_X.CEP | CEP do endereço | string |
| RESPOSTA.TELEFONES.REGISTRO_X.TIPO_CONTATO_TELEFONE | Classificação do telefone (Ex: COMERCIAL) | string |
| RESPOSTA.TELEFONES.REGISTRO_X.WHATSAPP | Indica se o número possui WhatsApp vinculado | string |
| RESPOSTA.TELEFONES.REGISTRO_X.DDD | Código DDD do telefone | string |
| RESPOSTA.TELEFONES.REGISTRO_X.TELEFONE | Número do telefone | string |
| RESPOSTA.EMAIL.REGISTRO_X.EMAIL | Endereço de e-mail associado à empresa | string |
| RESPOSTA.PARTICIPACAOSOCIETARIA.REGISTRO_X.CNPJ | CNPJ de outras empresas onde há participação | string |
| RESPOSTA.PARTICIPACAOSOCIETARIA.REGISTRO_X.RAZAOSOCIAL | Razão social das empresas onde há participação | string |
| RESPOSTA.PARTICIPACAOSOCIETARIA.REGISTRO_X.DOCUMENTO | Documento atrelado à participação societária | string |
| RESPOSTA.PARTICIPACAOSOCIETARIA.REGISTRO_X.PERCENTUAL | Percentual de participação na sociedade | string |
| RESPOSTA.PARTICIPACAOSOCIETARIA.REGISTRO_X.QUALIFICACAO | Qualificação na sociedade (Ex: SOCIO, ADMINISTRADOR) | string |
| RESPOSTA.INFOEMPRESA.NUMFUNC | Número estimado de funcionários | string |
| RESPOSTA.INFOEMPRESA.PORTE | Porte da empresa (Ex: DEMAIS, ME, EPP) | string |
| RESPOSTA.INFOEMPRESA.FATURAMENTO | Faixa de faturamento presumido | string |
| RESPOSTA.INFOEMPRESA.CAPITAL_SOCIAL | Valor do capital social da empresa | string |
| RESPOSTA.MATRIZ.REGISTRO_X.CONDICAO | Condição de atividade da matriz (Ex: ATIVA) | string |
| RESPOSTA.CNAE.REGISTRO_X.CODIGO | Código numérico da atividade econômica (CNAE) | string |
| RESPOSTA.CNAE.REGISTRO_X.DESCRICAO | Descrição textual da atividade econômica (CNAE) | string |
| RESPOSTA.FILIAIS.REGISTRO_X.QUANTIDADE | Quantidade total de filiais vinculadas ao CNPJ | string |
| RESPOSTA.FILIAIS.REGISTRO_X.ATIVA | Quantidade de filiais em situação ativa | string |
| RESPOSTA.QUADROSOCIETARIO.REGISTRO_X.NOME | Nome do sócio ou administrador da empresa | string |
| RESPOSTA.QUADROSOCIETARIO.REGISTRO_X.QUALIFICACAO | Papel exercido pelo membro no quadro societário | string |
| RESPOSTA.QUADROSOCIETARIO.REGISTRO_X.PERCENTUAL | Percentual de quotas do sócio na empresa | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.CONTAGEM | Quantidade total de processos jurídicos localizados | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.LISTLAWSUIT.REGISTRO_X.NUMEROPROCESSOUNICO | Número único do processo na justiça | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.LISTLAWSUIT.REGISTRO_X.TRIBUNAL | Sigla do tribunal onde tramita o processo | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.LISTLAWSUIT.REGISTRO_X.CLASSEPROCESSUAL.NOME | Classificação da ação jurídica | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.LISTLAWSUIT.REGISTRO_X.STATUSPREDICTUS.STATUSPROCESSO | Status atual de andamento do processo | string |
| RESPOSTA.RELATORIOJURIDICO.DATA.LISTLAWSUIT.REGISTRO_X.PARTES | Lista de partes envolvidas no processo | array de objetos |
| RESPOSTA.RELATORIOJURIDICO.DATA.[civel/trabalhista/outros/etc] | Contagem sumarizada de processos por cada esfera | string |
| RESPOSTA.PESQUISAQUODPJSCORE.REPORTPJRESPONSEEX.RESPONSE.RECORDS.REPORTPJOUTPUT.REGISTRO_0.SCOREPJ.SCORE | Pontuação de crédito PJ (Score) retornada pelo bureau Quod | string |
| RESPOSTA.PESQUISACREDNETLIGHT.DADOS_CONSULTA.DOCUMENTO | Documento alvo da consulta na base de crédito | string |
| RESPOSTA.PESQUISACREDNETLIGHT.CONFIRMEI.SITUACAO_CPFCNPJ | Situação cadastral do CNPJ na Receita Federal | string |
| RESPOSTA.PESQUISACREDNETLIGHT.SOCIOSACIONISTAS | Estrutura com dados de sócios/acionistas na base Serasa | objeto |
| RESPOSTA.PESQUISACREDNETLIGHT.ADMINISTRADORES | Estrutura com dados de administradores na base Serasa | objeto |
| RESPOSTA.PESQUISACREDNETLIGHT.CONSULTAS_SERASA | Resumo de consultas recentes ao CNPJ feitas pelo mercado | objeto |
| RESPOSTA.BACKGROUNDCHECK | Códigos ou IDs das pesquisas de background efetuadas no relatório | objeto |
Lógica de Resposta (Vetor de Status)
A API utiliza um sistema de mapeamento posicional dentro do array RESPOSTA.CODIGO. Esse array serve como um "sumário de integridade", permitindo identificar quais blocos de dados retornaram informações válidas e quais estão vazios, sem a necessidade de percorrer todo o objeto JSON.
| Código | Descrição |
|---|---|
| 1 | Bloco processado com sucesso e contém dados. |
| 2 | Bloco processado, mas não foram encontrados dados para o documento consultado. |
Bad Request
Unauthorized