Skip to main content
GET
/
api
/
watchlist
/
{id}
curl -X GET "https://api.finscreener.in/api/watchlist/wl_123?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "watchlist": {
    "id": "wl_123",
    "name": "Target Companies",
    "type": "company"
  },
  "items": [
    {
      "CIN": "U72200MH2004PTC148441",
      "companyName": "TATA CONSULTANCY SERVICES LIMITED",
      "City": "Mumbai",
      "llpStatus": "Active"
    }
  ],
  "total": 25,
  "page": 1,
  "pages": 3
}
Retrieve a specific watchlist with all its items.

​
Path Parameters

​
id
string
required
Watchlist ID

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Query Parameters

​
page
number
default:"1"
Page number
​
limit
number
default:"50"
Items per page
curl -X GET "https://api.finscreener.in/api/watchlist/wl_123?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "watchlist": {
    "id": "wl_123",
    "name": "Target Companies",
    "type": "company"
  },
  "items": [
    {
      "CIN": "U72200MH2004PTC148441",
      "companyName": "TATA CONSULTANCY SERVICES LIMITED",
      "City": "Mumbai",
      "llpStatus": "Active"
    }
  ],
  "total": 25,
  "page": 1,
  "pages": 3
}