GET /cnpj-data/:cnpj

Endpoint

GET https://api.bunny.build/api/v1/cnpj-data/:cnpj

Autenticação

Header	Obrigatório	Valor
`X-API-Key`	Sim	Sua chave de API (`bun_...`)

Visão geral

Consulte qualquer empresa brasileira registrada pelo CNPJ. A Bunny retorna razão social, nome fantasia, situação cadastral, data de abertura, natureza jurídica, atividade principal, endereço e capital: tudo o que você precisa para verificar um parceiro comercial ou pré-preencher formulários B2B.

Casos de uso

Verificação KYC e onboarding em plataformas B2B
Pré-preenchimento de formulários de cadastro de empresas
Validação de CNPJs de fornecedores e parceiros
Verificações de compliance e due diligence

Detalhes

Passe o CNPJ com ou sem formatação. Pontos, barras e hífens são removidos automaticamente. CNPJs inativos ou suspensos também são retornados com a situação cadastral indicada.

Parâmetros de rota

Parâmetro	Tipo	Obrigatório	Descrição
`cnpj`	string	Sim	CNPJ da empresa, somente dígitos (ex.: `11222333000181`)

Resposta

200 OK

Campo	Tipo	Descrição
`cnpj`	string	O CNPJ consultado
`name`	string \| null	Razão social
`trade_name`	string \| null	Nome fantasia
`status`	string \| null	Situação cadastral (ex.: `ATIVA`)
`type`	string \| null	Natureza jurídica
`opened_at`	string \| null	Data de abertura (ISO 8601)
`activity`	string \| null	Descrição da atividade principal
`address`	object \| null	Endereço (logradouro, cidade, estado, CEP)

Exemplo

{
  "cnpj": "11222333000181",
  "name": "EMPRESA EXEMPLO LTDA",
  "trade_name": "Empresa Exemplo",
  "status": "ATIVA",
  "type": "LTDA",
  "opened_at": "2010-05-20",
  "activity": "Desenvolvimento de software",
  "address": {
    "street": "Rua das Flores, 100",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01310100"
  }
}

401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

404 Not Found

CNPJ não encontrado.

{
  "detail": "CNPJ not found"
}

422 Unprocessable Entity

Formato de CNPJ inválido.

{
  "detail": "Invalid CNPJ format"
}

429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

Exemplo cURL

curl https://api.bunny.build/api/v1/cnpj-data/11222333000181 \
  -H "X-API-Key: bun_sua_chave_api"

​Endpoint

​Autenticação

​Visão geral

​Casos de uso

​Detalhes

​Parâmetros de rota

​Resposta

​200 OK

​401 Unauthorized

​402 Payment Required

​404 Not Found

​422 Unprocessable Entity

​429 Too Many Requests

​Exemplo cURL