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

# Paginated List Pipeline Documents

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

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'

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

---

[API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/revisions/b17341164de9/schema)