# apipj

> API REST de consulta de CNPJ a partir dos dados abertos da Receita Federal do Brasil (carga mensal). Plano gratuito com chave: 10 consultas por minuto e 50.000 por mês. A consulta de CNPJ exige conta (chave de API gratuita). Planos pagos a partir de R$ 12,90/mês. Dois formatos de resposta: completo (padrão) e simplificado (?formato=simplificado: formato plano com campos já formatados, datas DD/MM/AAAA, CNPJ e CEP com pontuação). Suporta CNPJ alfanumérico. Sandbox no navegador para quem tem conta.

Base da API: https://apipj.com.br/v1. Autenticação obrigatória em /v1/cnpj: Authorization: Bearer <chave> (sem chave: 401 unauthorized; /v1/valida e /v1/status são abertos). Respostas em JSON UTF-8; erros em {status:"ERROR", message, code}. Cabeçalhos X-RateLimit-* e X-Quota-* em toda resposta de /v1/cnpj.

## Documentação

- [Referência completa em Markdown](https://apipj.com.br/docs.md): endpoints, erros, limites, formatos, boas práticas
- [Documentação (HTML)](https://apipj.com.br/docs)
- [OpenAPI 3.1](https://apipj.com.br/openapi.json)
- [Sandbox](https://apipj.com.br/sandbox): teste no navegador (consulta exige conta grátis)

## Endpoints

- GET /v1/cnpj/{cnpj}?formato=completo|simplificado: documento cadastral (razão social, situação, CNAE, endereço, sócios, Simples/MEI)
- GET /v1/valida/{cnpj}: valida formato e dígito verificador (inclusive alfanumérico), sem cota
- GET /v1/status: estado da API, mês do dataset, número de CNPJs

## Preços e condições

- [Preços](https://apipj.com.br/precos): Gratuito R$ 0,00/mês (10/min, 50.000/mês); Dev R$ 12,90/mês (30/min, 200.000/mês); Pro R$ 59,90/mês (200/min, 600.000/mês)
- [Termos de uso](https://apipj.com.br/termos) · [Política de privacidade](https://apipj.com.br/privacidade)
- [Sobre e metodologia](https://apipj.com.br/sobre) · [Status](https://apipj.com.br/status)

## Contato

- brunogalizzi@masterbi.com