---
title: "GET /v1/demo"
description: "Demonstração sem chave"
canonical: "https://cnpj.ia.br/docs/referencia/get-demo"
date_modified: 2026-09-02
source: "cnpj.ia.br"
---

docs · base agosto/2026 Atualizado em 02/09/2026

# GET /v1/demo

Demonstração sem chave

Perfil `full` de instituições públicas de uma allowlist, sem o array `socios` (devolve `socios_count`). Cache de 1 hora, 10 requisições por minuto por IP. Serve o “Testar agora” do site.

## Créditos

chamada · **0** créditos

## Parâmetros

| Nome | Em | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- | --- |
| `cnpj` | query | `string` valor padrão: `00000000000191` | — | CNPJ da allowlist. Fora dela responde 404. |

## Respostas

### 200 OK

Perfil de demonstração.

### 404 Não encontrado

CNPJ válido ausente na base, ou removido a pedido do titular.

### 429 Excesso de requisições

Requisições por minuto da conta excedidas. Header Retry-After.

| Header | Tipo | Descrição |
| --- | --- | --- |
| `Retry-After` | `integer` | Só em 429 e 503: segundos até tentar de novo. |

## Exemplo

```bash
curl -s "https://api.cnpj.ia.br/v1/demo"
```