Overview
API Endpoint
POST /files-api/v1/list
Request Parameters
| Field | Subfield | Input Type | Required | Length Limit | Description / Rules |
|---|---|---|---|---|---|
| from_created_at | string | Yes | 25 | File creation start time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00 | |
| to_created_at | string | Yes | 25 | File creation end time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00 | |
| purpose | string | Yes | 50 | File purpose, enum value. Currently only supports: dispute_evidence | |
| page | string | No | 5 | Query page number, default is 1.If the page value is 0 or another non-positive integer, page 1 will be returned.If the page value exceeds the total page count, the last page will be returned. | |
| limit | string | No | 3 | Number of records per page.Supported values: 10, 50, 100.Any other value or empty value defaults to 10. |
Response Parameters (HTTP Code 200)
| Level 1 Field | Level 2 Field | Level 3 Field | Level 4 Field | Type | Description |
|---|---|---|---|---|---|
| code | string | API result code, 200, 400, 500 | |||
| msg | string | Result description, e.g. PARAM_ERROR | |||
| data | object | Node | |||
| lists | Array | ||||
| id | string | File ID | |||
| filename | string | File name | |||
| size | string | File size in bytes | |||
| type | string | File MIME type | |||
| purpose | string | File purpose | |||
| created | string | Creation time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00 | |||
| result_code | string | Returned response code | |||
| result_message | string | Returned response message | |||
| page | string | Current page number | |||
| total_count | string | Total record count | |||
| total_pages | string | Total number of pages |