> ## 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 Impressão Digital

> Verifique a identidade de uma pessoa de maneira rápida e segura, utilizando biometria das impressões digitais (até 10 dedos)

## Request Body

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

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

<ParamField body="fingers" type="array" required>
  Lista de impressões digitais a serem verificadas. Cada item representa uma digital com sua posição e imagem biométrica.

  <Expandable title="propriedades">
    <ParamField body="position" type="integer" required>
      Posição do dedo conforme tabela padrão NIST (1–10).

      1 - Polegar Direito

      2 - Indicador Direito

      3 - Médio Direito

      4 - Anelar Direito

      5 - Mínimo Direito

      6 - Polegar Esquerdo

      7 - Indicador Esquerdo

      8 - Médio Esquerdo

      9 - Anelar Esquerdo

      10 - Mínimo Esquerdo

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

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

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

## Response

<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="fingers" type="array">
  Lista com o resultado individual de cada digital verificada.

  <Expandable title="propriedades">
    <ResponseField name="position" type="integer">
      Posição da digital verificada, conforme enviado na requisição.

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

    <ResponseField name="confidence" type="string">
      Nível de confiança do reconhecimento biométrico para aquela digital. 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>
  </Expandable>
</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": "32c2775c-4d15-4201-be32-5886a397be6d",
        "cpf": "11144477735",
        "fingers": [
            {
                "position": 1,
                "confidence": "maximum"
            },
            {
                "position": 2,
                "confidence": "high"
            }
        ],
        "metadata": {
            "processingTime": 4269,
            "timestamp": "2026-04-20T19:04:17.412Z"
        }
    }
  ```

  ```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>