docs · base agosto/2026Atualizado em

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

NomeEmTipoObrigatórioDescrição
cnpjquerystring
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.

HeaderTipoDescrição
Retry-AfterintegerSó em 429 e 503: segundos até tentar de novo.

Exemplo

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