> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# ID Check Facial

> Verifique a identidade de uma pessoa de maneira rápida e segura utilizando uma foto da face

## Request Body

<ParamField body="cpf" type="string" required>
  CPF do titular a ser verificado.

  **Exemplo**: `12312312300`
</ParamField>

<ParamField body="image" type="string" required>
  Imagem em formato base64.

  **Exemplo**: `/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAg...`
</ParamField>

<ParamField body="confidenceLevel" type="string" required>
  Nível de confiança esperado.

  **Exemplo**: `HIGH`
</ParamField>

## Response

<ResponseField name="status" type="string">
  Status da validação. (APPROVED, REJECTED, NOT\_FOUND)

  **Exemplo**: `APPROVED`
</ResponseField>

<ResponseField name="confidence" type="string">
  Nível de confiança do resultado. Valores possíveis:

  **Low**: **Alta** probabilidade de **fraude**, recomendado reprovar

  **Medium**: **Alguma** probabilidade de **fraude**, zona cinzenta que precisa de reavaliação

  **High**: **Baixa** probabilidade de **fraude**, recomendado aprovar

  **Maximum**: Probabilidade **quase nula** de **fraude**, recomendado aprovar

  **Exemplo**: `MAXIMUM`
</ResponseField>

<ResponseField name="scanId" type="string">
  Identificador interno da transação.

  **Exemplo**: `123e4567-e89b-12d3-a456-426614174000`
</ResponseField>

<ResponseField name="cpf" type="string">
  CPF consultado.

  **Exemplo**: `12312312300`
</ResponseField>

<ResponseField name="valid" type="boolean">
  Validação baseado no nível de confiança recebido.

  **Exemplo**: `true`
</ResponseField>

<ResponseField name="processingTime" type="integer">
  Tempo total de processamento em milisegundos

  **Exemplo**: `345`
</ResponseField>

<ResponseField name="timestamp" type="datetime">
  Data e hora da transação

  **Exemplo**: `2025-11-21T18:00:00Z`
</ResponseField>

<ResponseExample>
  ```json 200 theme={"theme":"catppuccin-latte"}
  {
    "scanId": "123e4567-e89b-12d3-a456-426614174000",
    "cpf": "11144477735",
    "status": "APPROVED",
    "valid": true,
    "confidence": "high",
    "metadata": {
      "processingTime": 2345,
      "timestamp": "2025-11-21T18:00:00Z"
    }
  }
  ```

  ```json 400 theme={"theme":"catppuccin-latte"}
  {
    "error": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "requestId": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2025-10-21T10:00:00Z"
  }
  ```

  ```json 500 theme={"theme":"catppuccin-latte"}
  ```
</ResponseExample>