---
title: "Get status of a Upload"
method: GET
path: "/uploads/{upload_id}"
tags: ["uploads"]
---

# Get status of a Upload

`GET /uploads/{upload_id}`

## Request

- Base URL: `https://api.listclean.xyz/v1`
- URL: `https://api.listclean.xyz/v1/uploads/{upload_id}`
- Auth: API key in header `X-Auth-Token`

## Path parameters

- `upload_id` integer, required

## Response `200`

Response on success

- object
  - `success` 0 | 1: Success status, 0 for failed 1 for success
  - `message` string
  - `error_code` integer
  - `data` object
    - `status` string: Status of a upload. Note, the value of status is enum (list). It can be the following - inprocess, success, error
    - `progress` integer: completion percentage
    - `chunk_details` object
      - `total_chunk_count` integer: Total numbers of chunk in a upload
      - `uploaded_chunk_count` integer: Total numbers of successfully uploaded chunks
    - `request_id` integer: Listcleaner request_id for the upload

## Other responses

- `400`: List name is required
- `401`: Auth Failed

---

[API](https://skmtc.dev/listclean/apis/listclean-api-beta.md) · [All operations](https://skmtc.dev/listclean/apis/listclean-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/listclean/apis/listclean-api-beta/revisions/780c4fe6db87?raw)