Skip to main content
GET
/
api
/
screener
/
list
curl -X GET "https://api.finscreener.in/api/screener/list" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "screeners": [
    {
      "id": "scr_123",
      "name": "Mumbai IT Companies",
      "type": "company",
      "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "scr_456",
      "name": "Active GST Karnataka",
      "type": "gst",
      "query": "state == 'Karnataka' AND Status == 'Active'",
      "created_at": "2026-01-10T14:20:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "pages": 1
}
Retrieve all saved screener queries for 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

​
Response

​
screeners
array
curl -X GET "https://api.finscreener.in/api/screener/list" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "screeners": [
    {
      "id": "scr_123",
      "name": "Mumbai IT Companies",
      "type": "company",
      "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "scr_456",
      "name": "Active GST Karnataka",
      "type": "gst",
      "query": "state == 'Karnataka' AND Status == 'Active'",
      "created_at": "2026-01-10T14:20:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "pages": 1
}