> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/contact-list/delete-a-list.md).

# Delete a List

Permanently delete a specific subscriber list by its unique list UID. This action removes all associated list data and cannot be undone.

### 🗑️ Delete a List

Remove a subscriber list permanently using its unique list ID. This action cannot be undone.

#### 🔹 HTTP Request

```http
DELETE API-URL/lists/LIST-UNIQUE-ID
```

#### 🔸 URL Segments

| Segment          | Required | Description                              |
| ---------------- | -------- | ---------------------------------------- |
| `LIST-UNIQUE-ID` | Yes      | Unique identifier of the list to delete. |

#### 🔐 Authorization Header

Include your customer API key:

```
X-API-KEY: your-api-key-here
```

#### 💻 PHP Example

```php
// delete a list
$response = $endpoint->delete('LIST-UNIQUE-ID');

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';
```

#### 📦 Sample JSON Response

```json
{
  "status": "success"
}
```

{% hint style="danger" %}
Deleting a list is a **permanent action**. All associated data will be lost and cannot be recovered.
{% endhint %}