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"

Introdução

Referência da API

GET /cnpj-data/:cnpj

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

​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

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