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

# Listar Documentos OCR

> Liste os documentos enviados para extração de dados, com filtros e paginação

## Query Params

Os filtros são os mesmos de [Listar Documentos](/plataforma/documentoscopia/api/get-documents): `cpf`, `name`, `workflowPresetAlias`, `status`, `consolidatedStatus`, `createdFrom`, `createdTo`, `sortBy`, `sortOrder`, `limit` e `offset`.

## Response

<ResponseField name="items" type="array">
  Documentos OCR encontrados. Cada item traz os mesmos campos de [Consultar Documento](/plataforma/documentoscopia/api/get-document-by-id).

  Os dados extraídos não são retornados na listagem. Para obtê-los, consulte o documento pelo identificador.
</ResponseField>

<ResponseField name="pagination.total" type="integer">
  Total de documentos que atendem aos filtros.

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

<ResponseField name="pagination.limit" type="integer">
  Quantidade máxima de itens por página aplicada.

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

<ResponseField name="pagination.offset" type="integer">
  Número de itens ignorados na paginação.

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

<ResponseExample>
  ```json 200 theme={"theme":"catppuccin-latte"}
  {
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "organizationId": "123e4567-e89b-12d3-a456-426614174001",
        "projectId": "123e4567-e89b-12d3-a456-426614174002",
        "productId": "123e4567-e89b-12d3-a456-426614174003",
        "cpf": "12345678909",
        "status": "COMPLETED",
        "type": "ocr",
        "createdAt": "2026-06-01T12:00:00.000Z",
        "updatedAt": "2026-06-01T12:02:00.000Z",
        "sentAt": "2026-06-01T12:00:01.000Z",
        "sentToBackofficeAt": "2026-06-01T12:00:02.000Z",
        "finishedAt": "2026-06-01T12:02:00.000Z",
        "errorMessage": null,
        "errorCode": null,
        "backofficeBatchId": "229462",
        "requestId": "7d7a6f2b-8d9f-4f55-9a2d-ec8e7b4f1d0c",
        "name": "JOAO DA SILVA",
        "workflowPresetAlias": "ocr_auto_2min",
        "result": null
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 20,
      "offset": 0
    }
  }
  ```

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