Dados cadastrais CNPJ

Razão social, situação cadastral, CNAE, natureza jurídica e capital social de uma empresa pelo CNPJ.

Entrada: CNPJAssíncrona (requestId)

Gerar chave de API Ver preços

Quando usar

Cadastro de fornecedores

Valide a situação cadastral antes de homologar uma empresa.

Análise de crédito PJ

Confira situação, atividade e capital social no início da análise.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

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

Como acompanhar o resultado

Repita o GET a cada 2 ou 3 segundos até o status ser done ou error. A maioria das consultas termina em poucos segundos.

Passo 1

Criar consulta

POST/api/partner/v2/company/basic-data

Criar consulta de dados básicos (CNPJ).

Corpo da requisição

documentstringobrigatório
CNPJ com 14 dígitos (apenas números)

Respostas

200Solicitação criada com sucesso
400CNPJ inválido
401Não autorizado
402Saldo insuficiente

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/company/basic-data" \
  -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 resultado

GET/api/partner/v2/company/basic-data/{requestId}

Consultar resultado de dados básicos (CNPJ).

Parâmetros do caminho

requestIdstringno caminhoobrigatório

Respostas

200Resultado da solicitação

Requisição

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

Resposta · 200

{
  "data": {
    "document": "12345678000190",
    "country": "Brazil",
    "officialName": "EMPRESA EXEMPLO COMERCIO LTDA",
    "tradeName": "EXEMPLO STORE",
    "nameUniquenessScore": 1,
    "officialNameUniquenessScore": 1,
    "tradeNameUniquenessScore": 0.5,
    "foundedDate": "2015-08-20T00:00:00.000Z",
    "closedDate": null,
    "age": 11,
    "status": "ATIVA",
    "statusDate": "2015-08-20T00:00:00.000Z",
    "statusRegistrationDate": "2015-08-20T00:00:00.000Z",
    "creationDate": "2016-03-02T00:00:00.000Z",
    "lastUpdateDate": "2025-11-14T00:00:00.000Z",
    "alternativeIdNumbers": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "address": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "phone": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "email": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "website": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "socialMedia": {
      "NIRE": "35-2-1234567-8",
      "NIRECompanySize": "",
      "NIREHeadquartersType": "",
      "NIREHeadquartersCapital": "0",
      "NIRELastCaptureDate": "2019-10-09T12:00:00Z",
      "Capital": "CINQUENTA MIL REAIS",
      "CapitalRS": "50000.00",
      "COMEX": "PESSOA NAO HABILITADA A OPERAR NO COMERCIO EXTERIOR",
      "COMEXLastUpdate": "2020-10-22T12:00:00Z"
    },
    "activities": [
      {
        "id": 51001,
        "isMain": true,
        "code": "4511102",
        "activity": "COMERCIO A VAREJO DE AUTOMOVEIS, CAMIONETAS E UTILITARIOS USADOS",
        "basicDataCompanyId": 4120
      },
      {
        "id": 51002,
        "isMain": false,
        "code": "7490104",
        "activity": "ATIVIDADES DE INTERMEDIACAO E AGENCIAMENTO DE SERVICOS E NEGOCIOS EM GERAL, EXCETO IMOBILIARIOS",
        "basicDataCompanyId": 4120
      }
    ]
  },
  "status": "done"
}

O que a resposta traz

Cadastro

Razão social e nome fantasia
officialName · tradeName
Fundação e idade
foundedDate · age
Idade da empresa em anos.
Data de fechamento
closedDate
Preenchida quando a empresa foi baixada.
País
country
Natureza jurídica e tipo de empresaSó no painel
Matriz ou filial e regime tributárioSó no painel

Situação na Receita Federal

Situação cadastral
status
Ex.: ATIVA, BAIXADA, INAPTA, SUSPENSA, NULA.
Data da situação e data de inscrição
statusDate · statusRegistrationDate
Criação e atualização do cadastro
creationDate · lastUpdateDate

Atividades (CNAE)

CNAE principal e secundários
activities[]
Código de 7 dígitos, descrição e se é a atividade principal.

Capital e registro

Capital social
alternativeIdNumbers.CapitalRS
Valor numérico, com o valor por extenso em Capital.
NIRE
alternativeIdNumbers.NIRE
Registro na junta comercial, quando disponível.
Comércio exterior
alternativeIdNumbers.COMEX
Habilitação para importar e exportar.

Unicidade do nome

Unicidade da razão social e do nome fantasia
nameUniquenessScore · officialNameUniquenessScore · tradeNameUniquenessScore
De 0 a 1, quanto maior, mais raro. -1 quando não há nome fantasia.

No painel

Atalhos para telefones e processos da empresaSó no painel

Valores por plano

Plano mensal	Valor da consulta
Sob demanda	R$ 2,50
R$ 100/mês até 166 consultas	R$ 0,60
R$ 300/mês até 666 consultas	R$ 0,45
R$ 500/mês até 1.190 consultas	R$ 0,42
R$ 1.000/mês até 2.631 consultas	R$ 0,38
R$ 3.000/mês até 9.375 consultas	R$ 0,32
R$ 10.000/mês até 35.714 consultas	R$ 0,28
R$ 20.000/mês até 133.333 consultas	R$ 0,15

O valor é cobrado por consulta, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.

Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.

Comparar planos

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.

Dados cadastrais CPF

Nome, data de nascimento, filiação e situação cadastral de uma pessoa pelo CPF.

Telefones

Telefones vinculados a um CPF, com tipo, operadora e indicação de qual é o principal.

E-mails

E-mails vinculados a um CPF, com tipo (pessoal ou profissional), status de validação e prioridade.