Paulo · TF Fiscal
Escaneie para adicionar o Paulo no WeChat
Veja a documentação com exemplos prontos na linguagem que você usa.
API REST para consulta de CPF e CNPJ a partir da nossa base. Respostas em JSON, autenticação por token. URL base:
Após o primeiro acesso, confirme o seu e-mail pelo link que enviamos. Enquanto o e-mail não estiver confirmado, o painel fica limitado e a chave não é liberada.
No painel, preencha os dados da sua conta e da sua empresa em Perfil e Empresa & Acesso (Pessoa Jurídica).
Em Empresa & Acesso, envie o certificado digital do seu CNPJ e a senha do certificado para validar a sua empresa. Usamos apenas para validar — a senha não é armazenada. Sem a empresa validada, a chave não é liberada.
Cadastre o(s) IP(s), faixa(s) ou host(s) do seu servidor de onde as chamadas vão sair — a allowlist. A API só aceita requisições vindas desses endereços. Adicionar ou remover exige a sua senha e o código 2FA.
Com o e-mail confirmado, a empresa validada e ao menos um IP cadastrado, clique em Gerar chave (pede o código 2FA). A chave é exibida uma única vez — guarde-a em local seguro.
No painel você acompanha o seu consumo e créditos, o histórico de consultas, gerencia os seus IPs e chaves e vê o status da sua conta. Com a chave em mãos, siga para Autenticação e comece a consultar.
Use suas credenciais (consumer key e secret) para obter um token de acesso (OAuth2 client credentials). Envie o token como Authorization: Bearer <token> em cada chamada. A chave só funciona a partir dos IPs/hosts que você cadastrar (allowlist).
—
Retorna os dados do CPF da nossa base. CPF com 11 dígitos (máscara é ignorada). CPF inválido → 400; não encontrado → 404. Alias: /v1/cpf/{cpf}.
Variante com data de nascimento: /v1/cpf/{cpf}/{nascimento}, com a data no formato ddmmaaaa (ex.: 12041985), para confirmar o titular.
{
"ni": "01234567890",
"nome": "NOME DO TITULAR",
"situacao": { "codigo": "0", "descricao": "Regular" },
"nascimento": "12041985",
"nascimentoIso": "1985-04-12",
"idade": 40
}
Retorna os dados do CNPJ. 14 dígitos (máscara ignorada). Inválido → 400; não encontrado → 404. Alias: /v1/cnpj/{cnpj}.
{
"cnpj": "11.222.333/0001-81",
"razao_social": "EMPRESA EXEMPLO S.A.",
"situacao_cadastral": "Ativa",
"cnae_fiscal": "6422100",
"cnae_fiscal_descricao": "Bancos múltiplos, com carteira comercial",
"cnae_fiscal_secundaria": "6499999",
"cnae_secundaria_descricao": "Outras atividades de serviços financeiros",
"porte_empresa": "Demais",
"natureza_juridica": "Sociedade Anônima",
"opcao_simples": "Não",
"opcao_mei": "Não"
}
Versão mínima, para validação rápida e minimização de dados (LGPD): retorna só o essencial. Mesmo token.
{ "ni":"01234567890", "nome":"NOME DO TITULAR", "situacao":{"codigo":"0","descricao":"Regular"}, "idade":40, "maior_de_idade":true }
Consulte vários CPFs numa só chamada (até 2000). Envie um JSON com a lista.
{ "cpfs": ["01234567890","09876543210"] }
| Código | Significado |
|---|---|
| 200 | Sucesso — dados retornados. |
| 206 | Dados parciais retornados (cadastro sem data de nascimento). |
| 400 | CPF/CNPJ inválido (dígitos verificadores). |
| 401 | Token ausente ou inválido. |
| 403 | IP/host não autorizado (allowlist) ou acesso bloqueado. |
| 404 | Não encontrado na base. |
| 413 | Requisição muito grande — no lote, máximo de 2000 CPFs por chamada. |
| 422 | Titular entre 16 e 17 anos — dados não retornados (proteção LGPD). |
| 429 | Limite de requisições excedido (veja cabeçalhos X-RateLimit-*). |
| 451 | Indisponível por exigência legal — titular menor de 16 anos (LGPD). |
| 500 | Erro interno do servidor. |
| 502 | Erro de gateway (serviço upstream indisponível). |
| 503 | Serviço temporariamente indisponível. |
| 504 | Tempo de resposta excedido (gateway timeout). |
Toda resposta inclui o cabeçalho X-Request-Id para rastreio.