---
title: "Delete Contacts"
method: DELETE
path: "/v3/lists/{listId}/subscribers/bulk"
tags: ["Subscribers"]
---

# Delete Contacts

`DELETE /v3/lists/{listId}/subscribers/bulk`

This endpoint allows you to delete existing contacts from a certain list (if the list size is too big it might take a few seconds to completely erase data). You need to provide the unique identifier (listId) of the list where the contacts are located to delete the contacts. Query parameters and extra filters can be added using list's columns (e.g. email[like]=tester@example.com, age[gt]=30)

## Path parameters

- `listId` integer, required

## Response `202`

Successfully deleted the contacts

- BaseResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure

## Other responses

- `404` — Resource not found
- `409` — Duplicated data
- `500` — Internal server error

---

[API](https://skmtc.net/messangi/apis/raven.md) · [All operations](https://skmtc.net/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messangi/raven/versions/c87f398fa338/schema)