Otimiza B-Check

otimizapro.com/b-check · api de consulta de cnpj

API de consulta de CNPJ: a situação cadastral da Receita Federal em JSON, no seu sistema

A API de consulta de CNPJ do Otimiza B-Check devolve, para o CNPJ que você enviar, a razão social, a situação cadastral, o CNAE principal, o capital, a UF e a data de abertura, com a fonte de onde veio o dado. A consulta é um POST com JSON e uma chave Bearer, e o resultado entra direto no cadastro de cliente, no de fornecedor ou na esteira de onboarding.

Gerar minha API key sandbox não consome crédito Quero meu mês grátis

Sandbox roda a consulta de verdade sem debitar. Suporte técnico em PT-BR.

Exemplo de chamada

Um endpoint só para tudo: POST /consultas, com o slug do produto no corpo. Para a situação cadastral do CNPJ, o slug é pj.situacao-cnpj.

Situação cadastral do CNPJ: Pessoa Jurídica

# Request
curl -X POST https://kyc.otimizapro.com/api/v1/consultas \
  -H "Authorization: Bearer $OTIMIZA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"produto":"pj.situacao-cnpj",
       "input":{"cnpj":"00.000.000/0001-00"}}'

# Response 200 OK (resumo)
{
  "id": "01J...",
  "produto": "pj.situacao-cnpj",
  "status": "concluida",
  "creditos_consumidos": 1,
  "resultado": {
    "razao_social": "...",
    "situacao": "ATIVA",
    "cnae_principal": "...",
    "uf": "SP",
    "data_abertura": "..."
  },
  "fonte": "BrasilAPI / Receita Federal",
  "ambiente": "prod"
}

O que vem na resposta

Campo O que é
resultado.razao_social A razão social registrada na Receita Federal
resultado.situacao A situação cadastral do CNPJ, como ATIVA
resultado.cnae_principal A atividade principal da empresa
resultado.uf O estado da sede
resultado.data_abertura A data de abertura do CNPJ
fonte De onde veio o dado
creditos_consumidos Quantos créditos a consulta usou
id O identificador da consulta, para a auditoria

Para que as empresas usam

  • Cadastro de fornecedor: confirmar que o CNPJ existe e está ativo antes de pagar a primeira nota.
  • Abertura de cliente B2B: conferir a razão social e a atividade antes de liberar crédito.
  • Seller de marketplace: qualificar a empresa antes de aprovar a loja.

Quanto custa

Cada consulta de CNPJ consome 1 crédito, como no exemplo da documentação. No Avulso, a partir de R$ 0,75 por consulta, sem mensalidade e sem mínimo de volume. Nos Créditos pré-pagos, planos a partir de R$ 45 por mês. No Enterprise, R$ 489,90 por mês, com 2.000 créditos inclusos. Consulta sem retorno do provedor não consome crédito. Com o cupom 1MESGRATIS, a empresa testa por 1 mês grátis: conta nova, um por CNPJ, sem cartão de crédito.

Ver os preços completos

Consulta grátis ou API: quando cada uma serve

Caminho Serve para Onde para
Página da Receita Federal Consultar um CNPJ por vez, na tela Não entra no seu sistema nem roda em lote
APIs públicas gratuitas O ponto de partida Limite pequeno de requisições, indisponibilidade frequente, sem SLA e sem suporte
API do Otimiza B-Check O CNPJ na esteira, junto com o quadro societário, as certidões, as listas de PEP e de sanções e o audit log Cobra por consulta, a partir de R$ 0,75

O comparativo completo está em B-Check vs APIs gratuitas.

Lote, webhook e idempotência

  • Lote de até 100 consultas numa chamada, em POST /consultas:batch. Saldo insuficiente para o lote inteiro: 402, e nada é debitado.
  • Idempotência de 24 horas: o header Idempotency-Key devolve a resposta original, sem consumir créditos extras, quando a sua esteira repete a chamada.
  • Rate limit padrão de 60 requisições por minuto por chave.
  • Webhook assinado para as consultas que dependem de fonte lenta, e consulta do resultado em GET /api/v1/consultas/<id>.

Perguntas frequentes

Existe API de consulta de CNPJ gratuita?

Existe. A Receita Federal publica os dados do CNPJ em formato aberto, e há APIs públicas gratuitas que consultam a situação cadastral. Elas resolvem o ponto de partida, com limite pequeno de requisições, indisponibilidade frequente, sem SLA e sem suporte. O Otimiza B-Check junta, na mesma API, o CNPJ, o quadro societário, as certidões, as listas de PEP e de sanções e o audit log que uma operação regulada precisa.

Quanto custa consultar CNPJ por API no Otimiza B-Check?

Cada consulta de CNPJ consome 1 crédito. No Avulso, a partir de R$ 0,75 por consulta, sem mensalidade e sem mínimo de volume; nos Créditos pré-pagos, planos a partir de R$ 45 por mês. Com o cupom 1MESGRATIS, a empresa testa por 1 mês grátis.

Dá para consultar CNPJ em lote?

Sim. O POST /consultas:batch aceita até 100 consultas numa chamada. Se o saldo não cobre o lote inteiro, a resposta é 402, e nada é debitado.

A consulta de CNPJ traz os sócios?

A situação cadastral traz os dados da empresa. Os sócios e administradores vêm na consulta do quadro societário (pj.qsa), pela mesma chave e pelo mesmo endpoint.

API de sócios do CNPJ (QSA)

Posso testar antes de pagar?

Sim, de dois jeitos. O cadastro libera sandbox com créditos cortesia, e a consulta de CNPJ (PJ-RF-01) é um dos SKUs que dá para rodar nele. Para testar em produção, o cupom 1MESGRATIS dá 1 mês grátis para conta nova, um por CNPJ.

Pegue uma API key, rode em sandbox, depois ligue produção.

Gerar minha API key sandbox não consome crédito Quero meu mês grátis

Voltar à página principal.