Documentação da API.

A documentação Swagger UI da API Geoda está sendo preparada em ambiente dedicado. Enquanto isso, este resumo cobre o essencial da integração.

Atualizado em 4 de setembro de 2026.

Autenticação

Toda requisição precisa carregar Authorization: Bearer <sua_chave> no cabeçalho HTTP. A chave é individual por cliente e é entregue no momento da contratação ou início da POC. Chaves podem ser rotacionadas sob demanda.

Formato de resposta

JSON padrão. Corpos são sempre UTF-8. Erros retornam o padrão { "error": "codigo", "message": "detalhe legível" } com o HTTP status apropriado.

Anti-duplicação

Cada CNPJ retorna para o mesmo cliente apenas uma vez por período de faturamento. Repetição não conta no volume contratado. Isso significa que consultar o mesmo CNPJ duas vezes no mês custa o mesmo que uma consulta única.

Categorias de dados

Todo campo é marcado com sua categoria de origem, para que você saiba o nível de confiabilidade:

• oficial — direto de fonte pública governamental (RFB, ANTT, ANAC);
• enriquecido — obtido por pipeline próprio de coleta e validação;
• estimado — inferido por modelo de IA (faixa de faturamento, score).

Onde consumir

A API está disponível em api.geoda.com.br. O ambiente pode estar em provisionamento — se um ping não responder, entre em contato para confirmar disponibilidade.

Solicitar acesso

Se você ainda não tem chave, use o formulário na home e receba a chave de POC em até 24h úteis. Nenhum cartão é solicitado durante a POC.