---
title: "Return All Saved Watchlists"
method: GET
path: "/iserver/watchlists"
tags: ["tradingWatchlists"]
---

# Return All Saved Watchlists

`GET /iserver/watchlists`

Returns all saved watchlists stored on IB backend for the username in use in the current Web API session.

## Query parameters

- `SC` 'USER_WATCHLIST'

## Response `200`

Historical data query successfully returned data.

- WatchlistsResponse — Object containing a successful query for watchlists saved for the username in use in the current Web API session.
  - `data` WatchlistsResponseData — Contains the watchlist query results.
    - `scanners_only` boolean — Indicates if query results contain only market scanners.
    - `show_scanners` boolean — Indicates if market scanners are included in query results.
    - `bulk_delete` boolean — Indicates if username's watchlists can be bulk-deleted.
    - `user_lists` WatchlistsResponseDataUserListsItems[] — Array of objects detailing the watchlists saved for the username in use in the current Web API session.
      - `is_open` boolean — Internal use. Indicates if the watchlist is currently in use.
      - `read_only` boolean — Indicates if the watchlist can be edited.
      - `name` string — Display name of the watchlist.
      - `modified` integer — Unix timestamp in milliseconds of the last modification of the watchlist.
      - `id` string — Watchlist ID of the watchlist.
      - `type` 'watchlist' — Always has value 'watchlist'.
  - `action` 'content' — Internal use. Always has value 'content'.
  - `MID` string — Internal use. Number of times endpoint has been visited during session.

## Other responses

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