**Version: 202601**

# List files

**GET** `/openapi/2026-01/file`

List files in the media library.

## Request

**Query Parameters**

- `folder` string

  The folder name to fetch files from. Defaults to "all\_upload". Allowed values: -product - all\_upload
- `cursor` string

  Cursor for pagination
- `page_size` int32

  The number of files to retrieve per page. Defaults to 20 if not specified. Must be greater than 0 and less than or equal to 300
- `page` int32

  Page number (1-based). Mutually exclusive with cursor

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `files` object[]

    The list of files

    *   Array \[

    - `upload_link` string

      Upload file link
    - `file_uri` string

      File uri
    - `folder` string

      Folder
    - `size` int32

      File size
    - `type` string

      File type
    - `origin_link` string

      Origin link
    - `desc` string

      File description
    - `aspect_ratio` string

      File aspect ratio
    - `width` int32

      File width
    - `height` int32

      File height
    - `created_at` string

      Time of creation
    - `updated_at` string

      Time of update
    *   \]
  - `cursor` string

    The cursor for the next page of results
  - `has_more` boolean

    Whether there are more records
  - `total` int32

    Total number of records across all pages (for page-mode pagination)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "files": [
      {
        "upload_link": "string",
        "file_uri": "string",
        "folder": "string",
        "size": 0,
        "type": "string",
        "origin_link": "string",
        "desc": "string",
        "aspect_ratio": "string",
        "width": 0,
        "height": 0,
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```