Otimiza B-Check

otimizapro.com/b-check · api de sócios do cnpj

Consulta de sócios do CNPJ por API: o quadro societário (QSA) em JSON

O quadro de sócios e administradores (QSA) mostra quem é dono e quem responde pela empresa. A API do Otimiza B-Check devolve o QSA do CNPJ que você enviar, com o nome, a qualificação e a participação de cada sócio e administrador, para você saber quem assina antes de fechar contrato, abrir crédito B2B ou aprovar um seller.

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 o quadro societário, o slug é pj.qsa.

Quadro societário (QSA): quem manda na empresa

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

# Response 200 OK (resumo)
{
  "id": "01J...",
  "produto": "pj.qsa",
  "status": "concluida",
  "creditos_consumidos": 1,
  "resultado": {
    "razao_social": "...",
    "qsa": [
      {"nome": "...", "qualificacao": "Sócio-Administrador"}
    ]
  },
  "fonte": "BrasilAPI / Receita Federal"
}

O que vem na resposta

Campo O que é
resultado.razao_social A razão social da empresa consultada
resultado.qsa[].nome O nome do sócio ou administrador
resultado.qsa[].qualificacao A qualificação dele na empresa, como Sócio-Administrador
fonte De onde veio o dado
creditos_consumidos Quantos créditos a consulta usou
id O identificador da consulta, para a auditoria

Do QSA ao beneficiário final

O QSA é o primeiro nível. Quando o sócio é outra empresa, o Otimiza B-Check segue a cadeia: a consulta de UBO em cascata sobe pelos sócios até a pessoa física com 25% ou mais (ou 10%, no tier 3) e consome de 5 a 12 créditos. E, para KYB de fornecedor ou de cliente, o pack básico PJ (pj.pack-basico) junta a situação do CNPJ, o CEIS, o CNEP e a lista suja do MTE numa chamada, por 4 créditos.

Quanto custa

Cada consulta de QSA 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 Ver os sócios de um CNPJ por vez, na tela Não entra no seu sistema nem roda em lote
API do Otimiza B-Check O QSA na esteira, junto com a situação do CNPJ, as certidões, as listas de PEP e de sanções e o audit log Cobra por consulta, a partir de R$ 0,75

Os dados dos sócios e a LGPD

O QSA traz nomes de pessoas físicas. Use os dados dos sócios só para a finalidade da sua checagem, como cadastro, contrato ou crédito, com base legal, como pede a LGPD. Toda consulta fica no audit log: quem consultou, quando, com qual chave e qual versão.

Perguntas frequentes

Como consultar os sócios de um CNPJ?

Um por vez, na página da Receita Federal. Para consultar no seu sistema ou em lote, pela API do Otimiza B-Check: um POST /consultas com o slug pj.qsa e o CNPJ devolve o quadro de sócios e administradores em JSON.

Quanto custa consultar o QSA por API?

Cada consulta de QSA 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.

O QSA mostra o beneficiário final?

O QSA mostra os sócios do primeiro nível. Para chegar à pessoa física quando o sócio é outra empresa, use a consulta de UBO em cascata, que sobe pelos sócios até quem tem 25% ou mais (ou 10%, no tier 3).

Dá para consultar os sócios em lote?

Sim. O POST /consultas:batch aceita até 100 consultas numa chamada, e dá para misturar a situação do CNPJ e o QSA no mesmo lote.

Posso testar antes de pagar?

Sim. O cadastro libera sandbox com créditos cortesia, e o cupom 1MESGRATIS dá 1 mês grátis em produção 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.