---
title: "List parts"
method: GET
path: "/files/upload_sessions/{upload_session_id}/parts"
tags: ["Uploads (Chunked)"]
---

# List parts

`GET /files/upload_sessions/{upload_session_id}/parts`

Return a list of the chunks uploaded to the upload session so far.

The actual endpoint URL is returned by the [`Create upload session`](https://developer.box.com/reference/post-files-upload-sessions)
and [`Get upload session`](https://developer.box.com/reference/get-files-upload-sessions-id) endpoints.

## Path parameters

- `upload_session_id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Returns a list of parts that have been uploaded.

- UploadParts — The part of an API response that describes pagination.
  - `total_count` integer — One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than `total_count`. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `offset` integer — The 0-based offset of the first entry in this set. This will be the same as the `offset` query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `order` object[] — The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
    - `by` string — The field to order by.
    - `direction` 'ASC' | 'DESC' — The direction to order by, either ascending or descending.
  - `entries` UploadPart[] — A list of uploaded chunks for an upload session.
    - `part_id` string — The unique ID of the chunk.
    - `offset` integer — The offset of the chunk within the file in bytes. The lower bound of the position of the chunk within the file.
    - `size` integer — The size of the chunk in bytes.
    - `sha1` string — The SHA1 hash of the chunk.

## Other responses

- `default` — An unexpected client error.

---

[API](https://skmtc.dev/box/apis/platform-api.md) · [All operations](https://skmtc.dev/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)