---
title: "Delete the single list"
method: DELETE
path: "/lists/{list_id}"
tags: ["lists"]
---

# Delete the single list

`DELETE /lists/{list_id}`

## Request

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

## Path parameters

- `list_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

## 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)