Skip to main content
POST
/
api
/
watchlist
/
{id}
/
entities
# Add items
curl -X POST "https://api.finscreener.in/api/watchlist/wl_123/entities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "add",
    "items": ["U72200MH2004PTC148441"]
  }'

# Remove items
curl -X POST "https://api.finscreener.in/api/watchlist/wl_123/entities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "remove",
    "items": ["U72200MH2004PTC148441"]
  }'

{
  "message": "1 item(s) added successfully",
  "count": 26
}
Add or remove items from an existing watchlist.

​
Path Parameters

​
id
string
required
Watchlist ID

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Request Body

​
action
string
required
Action: add or remove
​
items
array
required
Array of identifiers (CINs, DINs, or GSTINs)
# Add items
curl -X POST "https://api.finscreener.in/api/watchlist/wl_123/entities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "add",
    "items": ["U72200MH2004PTC148441"]
  }'

# Remove items
curl -X POST "https://api.finscreener.in/api/watchlist/wl_123/entities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "remove",
    "items": ["U72200MH2004PTC148441"]
  }'

{
  "message": "1 item(s) added successfully",
  "count": 26
}