> ## 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.

# Enviar Documentos

> Envie documentos de identificação para análise de autenticidade

## Request Body

<ParamField body="cpf" type="string" required>
  CPF do titular do documento. Aceita 11 dígitos, com ou sem máscara, e os dígitos verificadores precisam ser válidos.

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

<ParamField body="documents.identification.front" type="string" required>
  Frente do documento em data URI base64.

  Limite de 10 MB. Formatos: JPG, JPEG, PNG e PDF.

  **Exemplo**: `data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...`
</ParamField>

<ParamField body="documents.identification.back" type="string">
  Verso do documento em data URI base64. Quando informado, frente e verso são unidos em um único PDF antes da análise.

  Limite de 10 MB. Formatos: JPG, JPEG, PNG e PDF.

  **Exemplo**: `data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...`
</ParamField>

<ParamField body="selfie" type="string">
  Selfie do titular em data URI base64, usada na comparação facial com a face do documento.

  Limite de 10 MB. Formatos: JPG, JPEG e PNG.

  **Exemplo**: `data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...`
</ParamField>

<ParamField body="workflowPresetAlias" type="string">
  Alias do preset de workflow que define o modo de análise e o prazo. Quando omitido, o preset configurado no projeto é aplicado.

  Consulte os valores disponíveis em [Listar Presets de Workflow](/plataforma/documentoscopia/api/get-workflow-presets).

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

<ParamField body="confidenceIdcheck" type="string">
  Nível de confiança esperado na comparação facial. Quando omitido, o valor configurado no projeto é aplicado.

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

<Note>
  O tamanho máximo do corpo da requisição não deve ultrapassar **50 MB**.
</Note>

## Response

<ResponseField name="requestId" type="string">
  Identificador da requisição.

  **Exemplo**: `7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c`
</ResponseField>

<ResponseField name="documentId" type="string">
  Identificador do documento criado. Use-o para consultar status, resultado, arquivos e face.

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

<ResponseField name="batchExternalId" type="string">
  Identificador externo do lote enviado para análise.

  **Exemplo**: `7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c`
</ResponseField>

<ResponseField name="backofficeBatchId" type="string">
  Identificador do lote gerado no processamento.

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

<ResponseField name="flexImageResponse" type="object">
  Retorno do serviço de processamento no envio do lote.
</ResponseField>

<ResponseExample>
  ```json 200 theme={"theme":"catppuccin-latte"}
  {
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "documentId": "123e4567-e89b-12d3-a456-426614174000",
    "batchExternalId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "backofficeBatchId": "229462",
    "flexImageResponse": {
      "id": "229462",
      "status": "created"
    }
  }
  ```

  ```json 400 theme={"theme":"catppuccin-latte"}
  {
    "error": "INVALID_WORKFLOW_PRESET",
    "message": "workflowPresetAlias inválido ou indisponível para documentoscopia",
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "timestamp": "2026-06-01T12:00:00.000Z"
  }
  ```

  ```json 400 theme={"theme":"catppuccin-latte"}
  {
    "error": "FLEXIMAGE_IMPORT_FAILED",
    "message": "Invalid file type for selfie: \"application/pdf\". Allowed types: jpg, jpeg, png",
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "timestamp": "2026-06-01T12:00:00.000Z"
  }
  ```

  ```json 502 theme={"theme":"catppuccin-latte"}
  {
    "error": "FLEXIMAGE_IMPORT_FAILED",
    "message": "Unknown error",
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "timestamp": "2026-06-01T12:00:00.000Z"
  }
  ```
</ResponseExample>