Desenvolvedores

API para Desenvolvedores

Gere CPF, CNPJ e os demais documentos de teste diretamente do seu backend, com autenticação por chave e cota mensal por plano.

Como obter uma chave

Ainda não temos checkout automático — entre em contato pelo WhatsApp para solicitar uma chave de API (plano Free, Pro ou Enterprise): +55 (54) 99963-9063.

Autenticação

Envie sua chave no header X-API-Key em toda requisição:

curl "https://seu-dominio.com/api/v1/gerar?tipo=cpf&quantidade=5" \
  -H "X-API-Key: SUA_CHAVE_AQUI"

Endpoint

GET /api/v1/gerar

Parâmetro	Descrição
`tipo`	Um de: `cpf`, `cnpj`, `rg`, `pis`, `cnh`, `cartao`, `senha`, `nome`, `titulo`, `renavam`, `cep`, `numeros`, `placa`, `conta`, `ie`, `certidao`, `pessoa`, `empresa`, `veiculo`, `telefone`, `nfe`
`quantidade`	1 a 50 (padrão: 1)
`formatado`	`1` ou `0` — com/sem pontuação (cpf, cnpj, rg, pis, cartao)
`uf`	Sigla de UF, só para `tipo=cpf`
`matriz`	`1`/`0`, só para `tipo=cnpj`
`bandeira`	visa/mastercard/amex/elo/diners/discover, só para `tipo=cartao`
`genero`	masculino/feminino/aleatorio, só para `tipo=nome`
`comprimento`	4 a 64, só para `tipo=senha`

Resposta

{
  "resultados": ["123.456.789-09"],
  "uso": { "usado": 12, "limite": 100 }
}

Erros

Status	Motivo
`400`	Parâmetro inválido (tipo ou UF inexistente)
`401`	Chave ausente, inválida, desativada ou expirada
`429`	Cota mensal do plano atingida

Todos os documentos gerados são números aleatórios que apenas seguem o algoritmo de dígito verificador — não pertencem a pessoas ou empresas reais. Uso exclusivo para testes e desenvolvimento de software.

Gostou das ferramentas? Ajude a manter o site no ar: apoiar via Pix · Política de Privacidade