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

{
  "data": [
    {
      "id": "wl_123",
      "name": "Target Companies",
      "type": "company",
      "count": 25,
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "total": 3,
  "page": 1,
  "limit": 10
}

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.

Retrieve all watchlists created by the authenticated user.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Query Parameters

​
page
number
default:"1"
Page number
​
limit
number
default:"10"
Results per page (max: 100)
​
search
string
Search watchlists by name

​
Response

​
data
array
curl -X GET "https://api.finscreener.in/api/watchlist?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "wl_123",
      "name": "Target Companies",
      "type": "company",
      "count": 25,
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "total": 3,
  "page": 1,
  "limit": 10
}