> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finscreener.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Watchlist

> Get watchlist details

Retrieve a specific watchlist by its ID.

## Path Parameters

<ParamField path="watchlist_id" type="string" required>
  Watchlist ID
</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.finscreener.in/api/watchlist/wl_123" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "wl_123",
      "name": "Target Companies",
      "type": "company",
      "count": 25,
      "created_at": "2026-01-15T10:00:00Z"
    }
  }
  ```
</ResponseExample>