List files

GET 
/openapi/2026-07/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

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

files object[]

The list of files

Array [

upload_linkstring

Upload file link

file_uristring

File uri

folderstring

Folder

sizeint32

File size

typestring

File type

origin_linkstring

Origin link

descstring

File description

aspect_ratiostring

File aspect ratio

widthint32

File width

heightint32

File height

created_atstring

Time of creation

updated_atstring

Time of update

]

cursorstring

The cursor for the next page of results

has_moreboolean

Whether there are more records

Example

{
  "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
  }
}