docs · base agosto/2026Atualizado em

GET /openapi.json

Contrato OpenAPI da API

Documento OpenAPI 3.1. Sem autenticação. Cache público de 1 hora. Permanece disponível na janela de manutenção da base.

Créditos

chamada · 0 créditos

Respostas

200 OK

Documento OpenAPI 3.1.

HeaderTipoDescrição
X-Request-IdstringIdentificador da requisição para suporte.
X-Client-Request-IdstringEco do X-Request-Id enviado pelo cliente quando casa ^[A-Za-z0-9_-]{8,64}$. Ausente se o cliente não enviou ou o valor é inválido. Nunca usado como identificador interno.
Cache-ControlstringCache público de 1 hora.
{
  "openapi": "3.1.0",
  "info": {
    "title": "cnpj.ia.br API",
    "version": "1.0.0-draft.4"
  }
}

404 Não encontrado

API desligada (CNPJIA_API_ENABLED diferente de on).

HeaderTipoDescrição
X-Request-IdstringIdentificador da requisição para suporte.
X-Client-Request-IdstringEco do X-Request-Id enviado pelo cliente quando casa ^[A-Za-z0-9_-]{8,64}$. Ausente se o cliente não enviou ou o valor é inválido. Nunca usado como identificador interno.
{
  "error": {
    "code": "not_found",
    "message": "Recurso não encontrado.",
    "request_id": "req_01J8ZK3Q9X",
    "retryable": false,
    "docs_url": "https://cnpj.ia.br/docs/erros-e-retentativas#not_found"
  }
}

500 Erro interno

Erro não previsto ao ler o documento. retryable: true; esta operação não consome créditos.

HeaderTipoDescrição
X-Request-IdstringIdentificador da requisição para suporte.
X-Client-Request-IdstringEco do X-Request-Id enviado pelo cliente quando casa ^[A-Za-z0-9_-]{8,64}$. Ausente se o cliente não enviou ou o valor é inválido. Nunca usado como identificador interno.
{
  "error": {
    "code": "internal_error",
    "message": "Erro interno. Tente novamente; se persistir, fale com o suporte.",
    "request_id": "req_01J8ZK3Q9X",
    "retryable": true,
    "docs_url": "https://cnpj.ia.br/docs/erros-e-retentativas#internal_error"
  }
}

Exemplo

curl -s "https://api.cnpj.ia.br/openapi.json"