Skip to main content
POST
/
id-check
/
api
/
v1
/
scan
/
face
ID Check
curl --request POST \
  --url https://api.valid.com/id-check/api/v1/scan/face \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "cpf": "<string>",
  "image": "<string>",
  "confidenceLevel": "<string>"
}
'
{
  "scanId": "123e4567-e89b-12d3-a456-426614174000",
  "cpf": "11144477735",
  "status": "APPROVED",
  "valid": true,
  "confidence": "high",
  "metadata": {
    "processingTime": 2345,
    "timestamp": "2025-11-21T18:00:00Z"
  }
}

​
Request Body

​
cpf
string
required
CPF a ser consultado.Exemplo: 12312312300
​
image
string
required
Imagem em formato base64.Exemplo: /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAg...
​
confidenceLevel
string
required
Nível de confiança esperado.Exemplo: HIGH

​
Response

​
status
string
Status da validação. (APPROVED, REJECTED, NOT_FOUND)Exemplo: APPROVED
​
confidence
string
Nível de confiança do resultado (MAXIMUM, HIGH, MEDIUM, LOW).Exemplo: MAXIMUM
​
scanId
string
Identificador interno da transação.Exemplo: 123e4567-e89b-12d3-a456-426614174000
​
cpf
string
CPF consultado.Exemplo: 12312312300
​
valid
boolean
Validação baseado no nível de confiança recebido.Exemplo: true
​
processingTime
integer
Tempo total de processamento em milisegundosExemplo: 345
​
timestamp
datetime
Data e hora da transaçãoExemplo: 2025-11-21T18:00:00Z
{
  "scanId": "123e4567-e89b-12d3-a456-426614174000",
  "cpf": "11144477735",
  "status": "APPROVED",
  "valid": true,
  "confidence": "high",
  "metadata": {
    "processingTime": 2345,
    "timestamp": "2025-11-21T18:00:00Z"
  }
}