# NextAPI

> API HTTP para consultar dados de empresas e endereços do Brasil: CNPJ, Simples Nacional e MEI, Inscrições Estaduais, CEP e geolocalização, CNAEs, estados e municípios, com dados da Receita Federal.

- URL base: https://api.nextapi.com.br (prefixo /v1)
- Autenticação: cabeçalho `Authorization: Bearer SEU_TOKEN`; o token é gerado no painel (https://admin.nextapi.com.br)
- Contrato OpenAPI 3.0: https://www.nextapi.com.br/docs/openapi.json
- Documentação completa em um arquivo: https://www.nextapi.com.br/llms-full.txt

## Documentação

- [Visão geral](https://www.nextapi.com.br/docs.md): o que a API oferece e por onde começar.
- [Primeiros passos](https://www.nextapi.com.br/docs/primeiros-passos.md): Crie seu token e faça a primeira consulta.
- [Autenticação](https://www.nextapi.com.br/docs/autenticacao.md): Envie seu token com segurança em cada requisição.
- [Créditos e limites](https://www.nextapi.com.br/docs/creditos-e-limites.md): Entenda o consumo, o saldo e as permissões do plano.
- [Atualização dos dados](https://www.nextapi.com.br/docs/atualizacao-dos-dados.md): Escolha entre cache e consulta com tolerância de atualização.
- [Tratamento de erros](https://www.nextapi.com.br/docs/erros.md): Identifique os códigos e saiba como reagir.
- [Usar com IA (MCP)](https://www.nextapi.com.br/docs/mcp.md): Conecte Claude, Cursor e VS Code à NextAPI pelo servidor MCP.
- [Referência da API](https://www.nextapi.com.br/docs/referencia.md): Consulte parâmetros, modelos, respostas e exemplos de todos os endpoints.

## Referência: CEPs

- [Consulta CEP por número](https://www.nextapi.com.br/docs/api/get-v1-ceps-cep.md): GET /v1/ceps/{cep}
- [Pesquisa avançada de CEPs](https://www.nextapi.com.br/docs/api/get-v1-ceps.md): GET /v1/ceps
- [Pesquisa geoespacial de CEPs por Latitude/Longitude](https://www.nextapi.com.br/docs/api/get-v1-ceps-geo.md): GET /v1/ceps/geo
- [Pesquisa geoespacial de CEPs](https://www.nextapi.com.br/docs/api/get-v1-ceps-geo-cep.md): GET /v1/ceps/geo/{cep}

## Referência: CNAEs

- [Lista CNAEs](https://www.nextapi.com.br/docs/api/get-v1-cnaes.md): GET /v1/cnaes

## Referência: CNPJ

- [Busca CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj.md): GET /v1/cnpj/{cnpj}
- [Busca dados do Simples Nacional do CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj-simples.md): GET /v1/cnpj/{cnpj}/simples
- [Busca Inscrições Estaduais do CNPJ](https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj-ie.md): GET /v1/cnpj/{cnpj}/ie
- [Busca CNPJs em lote](https://www.nextapi.com.br/docs/api/post-v1-cnpj-batch.md): POST /v1/cnpj/batch
- [Busca dados do Simples Nacional em lote](https://www.nextapi.com.br/docs/api/post-v1-cnpj-batch-simples.md): POST /v1/cnpj/batch/simples

## Referência: Créditos

- [Consulta Saldo de Créditos](https://www.nextapi.com.br/docs/api/get-v1-credits.md): GET /v1/credits

## Referência: Empresas

- [Busca Empresas](https://www.nextapi.com.br/docs/api/get-v1-empresas.md): GET /v1/empresas

## Referência: Estados

- [Lista Estados](https://www.nextapi.com.br/docs/api/get-v1-estados.md): GET /v1/estados

## Referência: Municípios

- [Lista Municípios](https://www.nextapi.com.br/docs/api/get-v1-municipios.md): GET /v1/municipios
- [Obtém Município por ID](https://www.nextapi.com.br/docs/api/get-v1-municipios-id.md): GET /v1/municipios/{id}

## Opcional

- [Planos e preços](https://www.nextapi.com.br/#pricing)
- [API CNPJ](https://www.nextapi.com.br/api-cnpj)
- [API Simples Nacional](https://www.nextapi.com.br/api-simples-nacional)