---
title: "List files in a volume path"
method: GET
path: "/files/list"
tags: ["pv"]
---

# List files in a volume path

`GET /files/list`

## Request

- The document declares no server URL.
- Auth: none declared

List files under base_path/rel_path with pagination, optionally recursive

## Query parameters

- `base_path` string, required
- `is_recursive` boolean
- `page` integer
- `page_size` integer
- `rel_path` string
- `since` string
- `until` string

## Response `200`

OK

- PkgServerVolumefsListResponse
  - `count` integer
  - `extra_data` PkgServerVolumefsListExtraData
    - `directory` integer
    - `files` integer
  - `results` PkgServerVolumefsFileItem[]
    - `is_dir` boolean
    - `mime` string
    - `modified_at` string
    - `name` string
    - `path` string
    - `size` integer

## Changes

- **2026-07-23** `a12b0f392336`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/daemon-api/changes/files/list/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/daemon-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/daemon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/daemon-api/revisions/b7207bf13d2c?raw)