Skip to main content
POST
/
api
/
screener
/
screeners
curl -X POST https://api.finscreener.in/api/screener/screeners \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == '\''Mumbai'\'' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai"
  }'

{
  "data": {
    "id": "scr_789",
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai",
    "created_at": "2026-02-04T12:00:00Z"
  }
}
Save an FQL query as a named screener for future use.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Request Body

​
name
string
required
Screener name
​
type
string
required
Entity type: company or gst
​
query
string
required
FQL query string
​
description
string
Optional description
Field names are case-sensitive! Company fields use PascalCase (City, State), GST fields use lowercase (state).
curl -X POST https://api.finscreener.in/api/screener/screeners \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == '\''Mumbai'\'' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai"
  }'

{
  "data": {
    "id": "scr_789",
    "name": "Mumbai IT Companies",
    "type": "company",
    "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
    "description": "IT companies in Mumbai",
    "created_at": "2026-02-04T12:00:00Z"
  }
}