## Get Watchlist By ID

`client.V1.Watchlist.GetWatchlistByID(ctx, watchlistID) (*V1WatchlistGetWatchlistByIDResponse, error)`

**get** `/v1/watchlists/{watchlist_id}`

Get a watchlist by ID with all its items

### Parameters

- `watchlistID string`

### Returns

- `type V1WatchlistGetWatchlistByIDResponse struct{…}`

  - `Data WatchlistDetail`

    Detailed watchlist with all items

    - `ID string`

      Watchlist ID

    - `CreatedAt Time`

      Creation timestamp

    - `Items []WatchlistItemEntry`

      Items in the watchlist

      - `ID string`

        Item ID

      - `AddedAt Time`

        When the item was added

      - `AddedPrice string`

        Price when the item was added

      - `Instrument Instrument`

        Instrument details

        - `ID string`

          Unique OEMS instrument identifier (UUID)

        - `CountryOfIssue string`

          The ISO country code of the instrument's issue

        - `Currency string`

          The ISO currency code in which the instrument is traded

        - `EasyToBorrow bool`

          Indicates if the instrument is classified as Easy-To-Borrow

        - `IsLiquidationOnly bool`

          Indicates if the instrument is liquidation only and cannot be bought

        - `IsMarginable bool`

          Indicates if the instrument is marginable

        - `IsRestricted bool`

          Indicates if the instrument is restricted from trading

        - `IsShortProhibited bool`

          Indicates if short selling is prohibited for the instrument

        - `IsThresholdSecurity bool`

          Indicates if the instrument is on the Regulation SHO Threshold Security List

        - `IsTradable bool`

          Indicates if the instrument is tradable

        - `Symbol string`

          The trading symbol for the instrument

        - `Venue string`

          The MIC code of the primary listing venue

        - `Adv string`

          Average daily share volume from the security definition.

        - `Expiry Time`

          The expiration date for options instruments

        - `InstrumentType SecurityType`

          The type of security (e.g., Common Stock, ETF)

          - `const SecurityTypeCommonStock SecurityType = "COMMON_STOCK"`

          - `const SecurityTypePreferredStock SecurityType = "PREFERRED_STOCK"`

          - `const SecurityTypeOption SecurityType = "OPTION"`

          - `const SecurityTypeCash SecurityType = "CASH"`

          - `const SecurityTypeOther SecurityType = "OTHER"`

        - `LongMarginRate string`

          The percent of a long position's value you must post as margin

        - `Name string`

          The full name of the instrument or its issuer

        - `NotionalAdv string`

          Notional ADV (`adv × previous_close`). The primary liquidity signal
          used by `/instruments/search` ranking. Computed at response time so
          it stays consistent with whatever `adv` and `previous_close` show.

        - `OptionsExpiryDates []Time`

          Available options expiration dates for this instrument.
          Present only when `include_options_expiry_dates=true` in the request.

        - `PreviousClose string`

          Last close price from the security definition.

        - `ShortMarginRate string`

          The percent of a short position's value you must post as margin

        - `StrikePrice string`

          The strike price for options instruments

    - `Name string`

      Watchlist name

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.Watchlist.GetWatchlistByID(context.TODO(), "550e8400-e29b-41d4-a716-446655440000")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}
```

#### Response

```json
{
  "data": {
    "created_at": "2025-01-15T10:00:00.000000000Z",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "added_at": "2025-01-16T09:30:00.000000000Z",
        "added_price": "150.25",
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "instrument": {
          "country_of_issue": "US",
          "currency": "USD",
          "easy_to_borrow": true,
          "id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
          "instrument_type": "COMMON_STOCK",
          "is_liquidation_only": false,
          "is_marginable": true,
          "is_restricted": false,
          "is_short_prohibited": false,
          "is_threshold_security": false,
          "is_tradable": true,
          "name": "Apple Inc.",
          "symbol": "AAPL",
          "venue": "XNMS"
        }
      }
    ],
    "name": "Tech Stocks"
  },
  "error": null,
  "metadata": {
    "request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
  }
}
```