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

# Obter Face do Documento

> Recupere em base64 a face extraída de um documento

## Path Params

<ParamField path="id" type="string" required>
  Identificador do documento, retornado no envio.

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

<Note>
  A face fica disponível apenas depois que o documento recebe o `backofficeBatchId`. Antes disso, a consulta retorna **422**.
</Note>

## Response

<ResponseField name="faces" type="array">
  Faces extraídas do documento.
</ResponseField>

<ResponseField name="faces[].docId" type="integer">
  Identificador do arquivo no processamento.

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

<ResponseField name="faces[].fileName" type="string">
  Nome do arquivo.

  **Exemplo**: `face_262740.pdf`
</ResponseField>

<ResponseField name="faces[].base64Content" type="string">
  Conteúdo da face em base64, em data URI.

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

<ResponseField name="faces[].typeAlias" type="string">
  Alias do tipo do documento de origem.

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

<ResponseField name="faces[].typeName" type="string">
  Nome do tipo do documento de origem.

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

<ResponseExample>
  ```json 200 theme={"theme":"catppuccin-latte"}
  {
    "faces": [
      {
        "docId": 262740,
        "fileName": "face_262740.pdf",
        "base64Content": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
        "typeAlias": "cnh",
        "typeName": "CNH"
      }
    ]
  }
  ```

  ```json 404 theme={"theme":"catppuccin-latte"}
  {
    "error": "NOT_FOUND",
    "message": "Document not found",
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "timestamp": "2026-06-01T12:00:00.000Z"
  }
  ```

  ```json 422 theme={"theme":"catppuccin-latte"}
  {
    "error": "FACE_NOT_AVAILABLE",
    "message": "Document has no backofficeBatchId yet",
    "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
    "timestamp": "2026-06-01T12:00:00.000Z"
  }
  ```

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