---
title: "List incomplete uploads"
method: GET
path: "/assets/multipart-uploads"
tags: ["multipartUpload"]
---

# List incomplete uploads

`GET /assets/multipart-uploads`

This method returns a list of all incomplete multipart upload sessions in your account.

## Query parameters

- `page` integer
- `page_limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

The list of incomplete upload sessions has been successfully retrieved.

- ListIncompleteUploadsResponse
  - `data` IncompleteUploadSummary[], required — An array containing information about your incomplete upload sessions, up to `page_limit` items.
    - `upload_id` string, required — The unique identifier of your upload session.
    - `status` 'active' | 'completed' | 'failed' | 'expired', required — The status of your upload session. This field can take one of the following values: - `active`: The upload session is currently in progress. Continue uploading and reporting the completion of each chunk. - `completed`: The platform received the file. The asset is created in the `processing` status and is not yet ready to use. Poll the [Retrieve an asset](/v1.3/api-reference/upload-content/direct-uploads/retrieve) endpoint until the status of the asset is `ready` before you use it. - `failed`: The upload session failed. You must restart with a new session. - `expired`: The upload session expired after 24 hours. You must create a new session.
    - `total_size` integer, required — Total size of the file in bytes.
    - `chunk_size` integer, required — The size of each chunk in bytes.
    - `total_chunks` integer, required — The total number of chunks in this upload session.
    - `created_at` string, date-time — A string representing the date and time, in RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the resource was created.
    - `expires_at` string, date-time — A string representing the date and time, in RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the resource will expire.
  - `page_info` PageInfo, required — An object that provides information about pagination.
    - `limit_per_page` integer — The maximum number of items on each page.
    - `page` integer — The page you retrieved.
    - `total_page` integer — The total number of pages.
    - `total_results` integer — The total number of results.

## Other responses

- `400` — The request has failed.
- `403` — The request has failed.
- `500` — The request has failed.

---

[API](https://skmtc.net/twelvelabs/apis/twelvelabs-api.md) · [All operations](https://skmtc.net/twelvelabs/apis/twelvelabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvelabs/twelvelabs-api/revisions/a332164b8c23/schema)