Skip to main content
POST
/
api
/
watchlist
/
create
curl -X POST "https://api.finscreener.in/api/watchlist/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Target Companies",
    "type": "company",
    "items": ["U72200MH2004PTC148441", "L17110MH1973PLC019786"]
  }'

{
  "id": "wl_789",
  "name": "Target Companies",
  "type": "company",
  "count": 2,
  "created_at": "2026-02-04T12:00:00Z"
}
Create a new watchlist to track companies, directors, or GST registrations.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Request Body

​
name
string
required
Watchlist name
​
type
string
required
Entity type: company, director, or gst
​
items
array
Initial items to add (CINs, DINs, or GSTINs)
curl -X POST "https://api.finscreener.in/api/watchlist/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Target Companies",
    "type": "company",
    "items": ["U72200MH2004PTC148441", "L17110MH1973PLC019786"]
  }'

{
  "id": "wl_789",
  "name": "Target Companies",
  "type": "company",
  "count": 2,
  "created_at": "2026-02-04T12:00:00Z"
}