**Version: 202601**

# Get upload file task

**GET** `/openapi/2026-01/file/task/:task_id`

Get the status and result of an upload task.

## Request

**Path Parameters**

- `task_id` string (required)

  The unique identifier of the upload task

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `task_id` string

    The task ID of the upload task
  - `total` int32

    The number of files that have been successfully uploaded
  - `finished` int32

    If the upload task is finished
  - `status` int32

    The status of the upload task
  - `success_list` object[]

    Success List of the uploaded files

    *   Array \[

    - `file_uri` string

      File URL
    - `origin_link` string

      The origin link of the file
    - `upload_link` string

      The upload file link
    *   \]
  - `failure_list` string[]

    Failed List of the uploaded files
  - `origin_list` string[]

    The original source list of the upload task

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "task_id": "string",
    "total": 0,
    "finished": 0,
    "status": 0,
    "success_list": [
      {
        "file_uri": "string",
        "origin_link": "string",
        "upload_link": "string"
      }
    ],
    "failure_list": [
      "string"
    ],
    "origin_list": [
      "string"
    ]
  }
}
```