---
title: "Delete lists"
method: DELETE
path: "/api/v1/contacts/lists"
tags: ["Lists"]
---

# Delete lists

`DELETE /api/v1/contacts/lists`

This API endpoint deletes a contact list(s)

## Request body

- DeleteListsDto
  - `listIds` string[], required — Array of list ids. if payload is empty or its length equals zero, then all lists with status deleted will be removed forever

## Response `204`

No content

## Other responses

- `400` — Bad model
- `401` — Unauthorized user

---

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