A forma mais fácil e rápida de integrar a API v2 da InfoSimples na sua aplicação Node.js.
A InfoSimples oferece uma API de consultas online (em tempo real) a portais públicos brasileiros — Receita Federal, Tribunais, Portal da Transparência, ANVISA, ANTT, CNJ, TCU e dezenas de outros órgãos, úteis para automações de KYC, due diligence, gestão cadastral e fiscal, e prevenção a fraudes.
Este pacote é um wrapper tipado e enxuto sobre essa API: cada endpoint vira um método de um client já autenticado, sem lógica de negócio própria além das chamadas HTTP.
- TypeScript-first — tipos de payload para cada endpoint e um
clienttotalmente tipado. - Client autenticado — informe o token uma única vez em
connect(); todos os métodos o reutilizam. - Superfície previsível — um método por endpoint, agrupado por órgão (
client.<órgão>.<consulta>()). - Sem dependências pesadas — apenas
axiosem runtime. - Retorno cru da API — cada método resolve com o
datada resposta da InfoSimples, sem transformação.
- Node.js >= 18
- Um token da API InfoSimples — crie o seu no painel de tokens.
# npm
npm install infosimples-sdk
# pnpm
pnpm add infosimples-sdk
# yarn
yarn add infosimples-sdk
# bun
bun add infosimples-sdkimport InfoSimples, { InfoSimplesClient } from 'infosimples-sdk';
const client: InfoSimplesClient = InfoSimples.connect({
token: process.env.INFOSIMPLES_TOKEN!,
});Cada método recebe um objeto com os parâmetros do endpoint e resolve com a resposta da API:
const resultado = await client.receitaFederal.cnpj({ cnpj: '00000000000191' });
console.log(resultado);Com .then()/.catch():
client.correios
.cep({ cep: '01310-930' })
.then(resposta => console.log(resposta))
.catch(erro => console.error(erro));Os parâmetros de cada endpoint são tipados. O tipo InfoSimplesClient descreve toda a árvore de
órgãos e métodos disponíveis — útil para injeção de dependência e para mocks em testes.
Os exemplos de uso de cada endpoint vivem na wiki do projeto, uma página por órgão:
- Receita Federal
- Tribunais
- Portal da Transparência
- Caixa
- Secretaria de Inspeção do Trabalho
- OFAC
- Anatel
- ANP
- ANTT
- Antecedentes Criminais
- ANVISA
- BCB
- Cadastur
- CNJ
- CVM
- MPF
- TCU
- CGU
- Correios
- INPI
- ONU
- ICIJ
Para a referência completa de parâmetros e formato de resposta de cada consulta, consulte a documentação oficial da InfoSimples.
⚠️ Em desenvolvimento. A API pública ainda pode mudar entre versões0.xsem aviso prévio. Fixe uma versão exata nopackage.jsonaté o1.0.0.
A cobertura de endpoints é ampliada continuamente; a lista sempre atual está na wiki.
- Ampliar a cobertura de endpoints da API InfoSimples, priorizando a esfera federal e o eixo Rio–SP.
- Concluir os tribunais restantes (TRFs, TRTs, TJs, TSE/TST).
- Tipar as respostas de cada endpoint (hoje apenas os parâmetros de entrada são tipados).
- Publicar um guia de contribuição dedicado.
Contribuições são bem-vindas — em especial para cobrir os endpoints que ainda faltam.
- Abra uma issue descrevendo a mudança antes de PRs grandes.
- Os commits seguem Conventional Commits (validados por
commitlint). - Antes de abrir o PR:
pnpm lint && pnpm build && pnpm test && pnpm format:check.
Arquitetura e convenções do repositório estão em AGENTS.md e docs/.
Veja CHANGELOG.md.
MIT © Alan Matias