---
title: "Paginated List Pipeline Documents"
method: GET
path: "/api/v1/pipelines/{pipeline_id}/documents/paginated"
tags: ["Pipelines"]
deprecated: true
---

# Paginated List Pipeline Documents

`GET /api/v1/pipelines/{pipeline_id}/documents/paginated`

## Request

- Base URL: `https://api.cloud.llamaindex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloud.llamaindex.ai/api/v1/pipelines/{pipeline_id}/documents/paginated`
- Auth: HTTP bearer

> **Deprecated.**

Return a list of documents for a pipeline.

## Path parameters

- `pipeline_id` string, uuid, required

## Query parameters

- `skip` integer
- `limit` integer
- `file_id` string, uuid, nullable
- `only_direct_upload` boolean, nullable
- `only_api_data_source_documents` boolean, nullable
- `status_refresh_policy` 'cached' | 'ttl'
- `project_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- PaginatedListCloudDocumentsResponse
  - `documents` CloudDocument[], required: The documents to list
    - `text` string, required
    - `metadata` object, required
    - `excluded_embed_metadata_keys` string[]
    - `excluded_llm_metadata_keys` string[]
    - `page_positions` integer[], nullable: indices in the CloudDocument.text where a new page begins. e.g. Second page starts at index specified by page_positions[1].
    - `id` string, required
    - `status_metadata` object, nullable
  - `limit` integer, required: The limit of the documents
  - `offset` integer, required: The offset of the documents
  - `total_count` integer, required: The total number of documents

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `a38b684f8e1b`: 1 warning, 4 info
  - for the `query` request parameter `limit`, the max was set to `1000.00`
  - endpoint deprecated
  - added the new optional `query` request parameter `project_id`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - …1 more
- **2026-06-09** `614771991b52`: 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-09** `b17341164de9`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/run-llama/apis/llama-platform/changes/api/v1/pipelines/:pipeline_id/documents/paginated/get.md)

---

[API](https://skmtc.dev/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.dev/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/run-llama/apis/llama-platform/revisions/eacba11f3303?raw)