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

# Watchlist Guide

> Track companies and entities you're interested in

## Overview

Watchlists allow you to organize and track companies, directors, and GST entities that are relevant to your business needs.

## Creating a Watchlist

<Steps>
  <Step title="Navigate to Watchlists">
    Go to the Watchlist section in your dashboard.
  </Step>

  <Step title="Create New Watchlist">
    Click "+ New" to create a new watchlist.
  </Step>

  <Step title="Configure Watchlist">
    * Enter a name for your watchlist
    * Select the type: Company, Director, or GST
    * Optionally add initial entities
  </Step>
</Steps>

## Adding Entities

You can add entities to a watchlist in several ways:

### From Search Results

1. Search for a company, director, or GST record
2. Click "Add to Watchlist" on the entity card
3. Select the target watchlist

### From Detail Pages

1. View the detailed profile of an entity
2. Click the "Add to Watchlist" button
3. Choose your watchlist

### Via API

```bash theme={null}
curl -X POST https://api.finscreener.in/api/watchlist/{watchlist_id}/entities \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entities": [
      {"identifier": "U72200MH2007PTC117607", "name": "Example Company Ltd"}
    ]
  }'
```

## Managing Watchlists

### Viewing Entities

* Click on a watchlist to see all entities
* Search within the watchlist
* Sort by name or date added

### Removing Entities

* Select entities to remove
* Click the remove button
* Confirm deletion

### Deleting Watchlists

* Go to watchlist settings
* Click "Delete Watchlist"
* Confirm deletion (entities are not deleted, only removed from the list)

## Use Cases

<CardGroup cols={2}>
  <Card title="Investment Tracking" icon="chart-line">
    Track potential investment targets and monitor their status changes.
  </Card>

  <Card title="Competitor Monitoring" icon="binoculars">
    Keep an eye on competitors and new entrants in your industry.
  </Card>

  <Card title="Client Management" icon="users">
    Organize current and potential clients for easy access.
  </Card>

  <Card title="Due Diligence" icon="magnifying-glass">
    Group entities for compliance and background verification.
  </Card>
</CardGroup>

## API Reference

<Card title="Watchlist API" icon="code" href="/api-reference/watchlist/list">
  View the complete Watchlist API documentation.
</Card>