---
title: "List Pipeline Files"
method: GET
path: "/api/v1/beta/pipelines/{pipeline_id}/files"
tags: ["Beta", "Pipeline Files"]
---

# List Pipeline Files

`GET /api/v1/beta/pipelines/{pipeline_id}/files`

## 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/beta/pipelines/{pipeline_id}/files`
- Auth: HTTP bearer

List files for a pipeline with pagination and filtering.

## Path parameters

- `pipeline_id` string, uuid, required

## Query parameters

- `data_source_id` string, uuid, nullable: Filter by data source ID.
- `file_name_contains` string, nullable: Filter by files whose names contain this substring (case-insensitive).
- `statuses` string[], nullable: Filter by pipeline file statuses.
- `page_size` integer, nullable: Maximum number of items to return. Defaults to 50, max 1000.
- `page_token` string, nullable: Page token for pagination, from a previous response.
- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- PipelineFileListResponse: Beta API query response schema for pipeline files.
  - `items` PipelineFileResponse[], required: The list of items.
    - `id` string, uuid, required: Unique identifier for the pipeline file.
    - `name` string, nullable: Name of the file.
    - `external_file_id` string, nullable: The ID of the file in the external system.
    - `file_size` integer, nullable: Size of the file in bytes.
    - `file_type` string, nullable: File type (e.g. pdf, docx, etc.).
    - `project_id` string, uuid, nullable: The ID of the project that the file belongs to.
    - `last_modified_at` string, date-time, nullable: The last modified time of the file.
    - `file_id` string, uuid, nullable: The ID of the file.
    - `pipeline_id` string, uuid, required: The ID of the pipeline that the file is associated with.
    - `resource_info` object, nullable: Resource information for the file.
    - `permission_info` object, nullable: Permission information for the file.
    - `custom_metadata` object, nullable: Custom metadata for the file.
    - `data_source_id` string, uuid, nullable: The ID of the data source that the file belongs to.
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'SUCCESS' | 'ERROR' | 'CANCELLED', nullable: Status of the pipeline file.
    - `status_updated_at` string, date-time, nullable: The last time the status was updated.
    - `created_at` string, date-time, nullable: When the pipeline file was created.
    - `updated_at` string, date-time, nullable: When the pipeline file was last updated.
  - `next_page_token` string, nullable: A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `total_size` integer, nullable: The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `a38b684f8e1b`: 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
- **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/beta/pipelines/:pipeline_id/files/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/809d302cdb1e?raw)