---
title: "Delete A Saved Watchlist"
method: DELETE
path: "/iserver/watchlist"
tags: ["tradingWatchlists"]
---

# Delete A Saved Watchlist

`DELETE /iserver/watchlist`

Delete a specified watchlist from the username's settings.

## Query parameters

- `id` string, required

## Response `200`

Successful deletion of specified watchlist.

- WatchlistDeleteSuccess — Object detailing the successful deletion of a watchlist.
  - `data` WatchlistDeleteSuccessData
    - `deleted` string — Watchlist ID of the deleted watchlist.
  - `action` 'context' — Internal use. Always has value 'context'.
  - `MID` string — Internal use. Number of times endpoint has been visited during session.

## Other responses

- `400` — Missing, empty, non-numeric, or out-of-range parameter. The `error` field is always prefixed with `Bad Request:`.
- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)