Skip to main content

Overview

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

Creating a Watchlist

1

Navigate to Watchlists

Go to the Watchlist section in your dashboard.
2

Create New Watchlist

Click ”+ New” to create a new watchlist.
3

Configure Watchlist

  • Enter a name for your watchlist
  • Select the type: Company, Director, or GST
  • Optionally add initial entities

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

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

Investment Tracking

Track potential investment targets and monitor their status changes.

Competitor Monitoring

Keep an eye on competitors and new entrants in your industry.

Client Management

Organize current and potential clients for easy access.

Due Diligence

Group entities for compliance and background verification.

API Reference

Watchlist API

View the complete Watchlist API documentation.