api

API de Validação e Geração de CPF e CNPJ

Esta API oferece endpoints para validar e gerar números de CPF e CNPJ com base nas regras de validação estabelecidas. As regras de validação utilizadas nesta API seguem os cálculos descritos em Regra de Validação para CPF e CNPJ.

Observação: A partir de julho de 2026, o CNPJ será formada por números e letras para aumentar capacidade de novos cadastros, por isso, criei um novo repositório com o novo algoritmo de validação. Por favor, utilize o novo e mais completo repositório:

Novo formato de CNPJ Brasil

Agradeço ao theofurtado05, autor do repositório original. Somente a publicação de deploy original URL original não está mais ativa. Caso você queira usar a API publicada, segue a URL base da publicação nova, funcionando, sem restrição:

URL base da API publicada

Validar CPF

Endpoint: /validarcpf/:cpf

Descrição: Este endpoint permite a validação de um número de CPF fornecido como parâmetro. Ele retorna uma resposta indicando se o CPF é válido ou não, com base nas regras de validação estabelecidas.

Requisição:

• Método: GET
• Parâmetros:
  • cpf (string) - O número de CPF a ser validado.

Exemplo de Requisição:

GET /validarcpf/12345678909

Resposta:

{
  "valid": true,
  "message": "O CPF é válido."
}

Gerar CPF

Endpoint: /gerarcpf

Descrição: Este endpoint permite a geração de um novo número de CPF válido de forma aleatória. O CPF gerado é retornado como resposta.

Requisição:

• Método: GET

Exemplo de Requisição: GET /gerarCpf

Resposta:

{
    "cpf": "123.456.789-09",
    "cpf_formatado": "12345678909"
}

Validar CNPJ

Endpoint: /validarcnpj/:cnpj

Descrição: Este endpoint permite a validação de um número de CNPJ fornecido como parâmetro. Ele retorna uma resposta indicando se o CNPJ é válido ou não, com base nas regras de validação estabelecidas.

Requisição:

• Método: GET
• Parâmetros:
  • cnpj (string) - O número de CNPJ a ser validado.

Exemplo de Requisição:

GET /validarcnpj/12345678000101

Resposta:

{
  "valid": true,
  "message": "O CNPJ é válido."
}

Gerar CNPJ

Endpoint: /gerarcnpj

Descrição: Este endpoint permite a geração de um novo número de CNPJ válido de forma aleatória. O CNPJ gerado é retornado como resposta.

Requisição:

• Método: GET

Exemplo de Requisição: GET /gerarcnpj

Resposta:

{
    "cnpj": "12.345.678/0001-01",
    "cnpj_formatado": "12345678000101"
}

Considerações Finais

Esta API oferece a validação e geração de CPF e CNPJ com base nas regras de validação estabelecidas, tornando-a uma ferramenta útil para diversas aplicações. Certifique-se de utilizar os endpoints corretamente de acordo com suas necessidades.

Para obter mais informações sobre as regras de validação utilizadas nesta API, consulte Regra de Validação para CPF e CNPJ.

Aproveite os recursos desta API e integre-a em seus projetos para facilitar a validação e geração de CPF e CNPJ.