Skip to main content
GET
/
api
/
screener
/
screeners
/
{screener_id}
curl -X GET "https://api.finscreener.in/api/screener/screeners/scr_123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "id": "scr_123",
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

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 a saved screener by its ID.

​
Path Parameters

​
screener_id
string
required
Screener ID

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Response

​
data
object
Screener details including name, type, query, and description
curl -X GET "https://api.finscreener.in/api/screener/screeners/scr_123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "id": "scr_123",
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai",
    "created_at": "2026-01-15T10:30:00Z"
  }
}