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

# List files in a volume path

`GET /files/list`

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

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

---

[API](https://skmtc.dev/tencentblueking/apis/untitled-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/untitled-api/revisions/a12b0f392336/schema)