Validacao CPF

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

Endpoint

POST /api/external/cpf/validate

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	String	Sim	ApiKey {client_id}:{client_secret}
Content-Type	String	Sim	application/json

Request Body

Campo	Tipo	Obrigatorio	Descricao	Exemplo
cpf	String	Sim	Numero do CPF (com ou sem formatacao)	"12345678909" ou "123.456.789-09"

Alias

O campo document_number tambem e aceito como alias.

Exemplo

curl -X POST https://api.owem.com.br/api/external/cpf/validate \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"cpf":"12345678909"}'

Resposta de Sucesso -- CPF Valido (200)

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

Resposta de Sucesso -- CPF Invalido (200)

{
  "worked": true,
  "valid": false,
  "formatted": null
}

Campo	Tipo	Descricao
worked	Boolean	true indica que a requisicao foi processada
valid	Boolean	true se o CPF e valido, false caso contrario
formatted	String	CPF 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)

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

Resposta de Erro (401)

{
  "error": {
    "status": 401,
    "message": "Missing API key credentials. Use Authorization: ApiKey <client_id>:<client_secret>"
  }
}

Uso

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