---
title: "Return A Single Saved Watchlist"
method: GET
path: "/iserver/watchlist"
tags: ["tradingWatchlists"]
---

# Return A Single Saved Watchlist

`GET /iserver/watchlist`

Retrieve details of a single watchlist stored in the username's settings.

## Query parameters

- `id` string, required

## Response `200`

Successful deletion of specified watchlist.

- SingleWatchlist — Object detailing a single watchlist.
  - `id` string — Identifier of the watchlist.
  - `hash` string — Internal use. Unique hash of the watchlist.
  - `name` string — Human-readable display name of the watchlist.
  - `readOnly` boolean — Indicates whether the watchlist can be edited.
  - `instruments` SingleWatchlistEntry[] — Array of instruments contained in the watchlist.
    - `ST` 'STK' | 'OPT' | 'FUT' | 'BOND' | 'FUND' | 'WAR' | 'CASH' | 'CRYPTO' — All-capital, shorthand security type identifier of the instrument.
    - `C` string — Instrument conid as a string.
    - `conid` integer — IB contract ID of the instrument.
    - `name` string — Complete display name of the instrument.
    - `fullName` string — Full display presentation of the instrument symbol.
    - `assetClass` 'STK' | 'OPT' | 'FUT' | 'BOND' | 'FUND' | 'WAR' | 'CASH' | 'CRYPTO' — All-capital, shorthand security type identifier of the instrument.
    - `ticker` string — Symbol of the instrument.
    - `chineseName` string — Rendering of the instrument name in Chinese.

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