Skip to content

Validacao CPF

Valida um numero de CPF verificando formato e digitos verificadores pelo algoritmo Modulo 11.

Endpoint

POST /api/v2/external/cpf/validate

Headers

HeaderTipoObrigatorioDescricao
AuthorizationStringSimBearer {access_token}
Content-TypeStringSimapplication/json

Request Body

CampoTipoObrigatorioDescricaoExemplo
document_numberStringSimNumero do CPF (com ou sem formatacao)"12345678909" ou "123.456.789-09"

Exemplo

bash
curl -X POST https://api.owem.com.br/api/v2/external/cpf/validate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"document_number":"12345678909"}'

Resposta de Sucesso -- CPF Valido (200)

json
{
  "worked": true,
  "valid": true,
  "formatted": "123.456.789-09"
}

Resposta de Sucesso -- CPF Invalido (200)

json
{
  "worked": true,
  "valid": false,
  "formatted": null
}
CampoTipoDescricao
workedBooleantrue indica que a requisicao foi processada
validBooleantrue se o CPF e valido, false caso contrario
formattedStringCPF formatado (XXX.XXX.XXX-XX) se valido, null se invalido

Validacoes Realizadas

  1. Verifica se o CPF possui exatamente 11 digitos
  2. Rejeita CPFs com todos os digitos iguais (ex: 111.111.111-11)
  3. Calcula e verifica os 2 digitos verificadores pelo algoritmo Modulo 11

Resposta de Erro (400)

json
{
  "worked": false,
  "detail": "O campo document_number e obrigatorio"
}

Resposta de Erro (401)

json
{
  "worked": false,
  "detail": "Token invalido ou expirado"
}

Uso

Este endpoint realiza apenas validacao matematica do CPF (Modulo 11). Nao consulta a Receita Federal nem verifica a situacao cadastral do documento.

Owem Pay Instituição de Pagamento — ISPB 37839059