# Informações Básicas


# 📡 Documentação da API - Casa dos Dados

A **API da Casa dos Dados** permite realizar consultas de CNPJ, pesquisas avançadas, verificação de saldo e mais. Está disponível nas versões `v4` e `v5`.

---

## 🌐 Host da API

```
https://api.casadosdados.com.br
```

---

## 🔐 Autenticação

Para autenticar as requisições, você deve utilizar uma **chave de API (`api-key`)**.  
Obtenha sua chave acessando:

👉 [https://portal.casadosdados.com.br/plataforma/api/chave](https://portal.casadosdados.com.br/plataforma/api/chave)

Inclua o token no **header** da requisição:

```http
api-key: SUA_CHAVE_DE_API
```

### Códigos de erro comuns

- **401 Unauthorized**: A chave `api-key` não foi enviada ou está incorreta.
- **403 Forbidden**: A chave está correta, mas você não tem acesso ao recurso solicitado.

---

## 💰 Requisitos de Saldo

Algumas rotas requerem **saldo disponível** para serem utilizadas:

- Consulta de **CNPJ**
- **Pesquisa Avançada**

Garanta que seu saldo seja maior que zero para utilizar essas rotas.

---

## 📘 Versões da API

As versões disponíveis são:

- `v4`
- `v5`

Recomendamos o uso da **versão mais recente** (`v5`) sempre que possível.

---

## ❓ Suporte

Para dúvidas, sugestões ou problemas de integração, acesse:

👉 [Seção de Suporte e Contato](https://portal.casadosdados.com.br/suporte/contato)

---

## 📄 Exemplo de Requisição com `curl`

```bash
curl -X GET "https://api.casadosdados.com.br/v4/cnpj/00000000000191" \
  -H "api-key: SUA_CHAVE_DE_API"
```

---

## ⚠️ Observações

- Certifique-se de sempre enviar a chave correta no header `api-key`.
- Evite erros de autenticação e monitore seu saldo.
- Novas versões da API podem incluir melhorias e novos recursos. Fique atento às atualizações no portal.

---

**Casa dos Dados ©**  
[https://portal.casadosdados.com.br](https://portal.casadosdados.com.br)