Skip to main content
POST
/
api
/
screener
/
search
curl -X POST https://api.finscreener.in/api/screener/search \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "State == '\''Maharashtra'\'' AND paidUpCapital > 5000000",
    "type": "company",
    "page": 1,
    "limit": 10
  }'

{
  "results": [
    {
      "CIN": "L17110MH1973PLC019786",
      "companyName": "RELIANCE INDUSTRIES LIMITED",
      "State": "Maharashtra",
      "City": "Mumbai",
      "paidUpCapital": 6766000000,
      "llpStatus": "Active"
    }
  ],
  "total": 1523,
  "page": 1,
  "pages": 153
}

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.

Execute an FQL (Finscreener Query Language) query to search and filter companies or GST registrations.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Request Body

​
query
string
required
FQL query string (e.g., state == 'Maharashtra' AND paidUpCapital > 5000000)
​
type
string
required
Entity type: company or gst
​
page
number
default:"1"
Page number
​
limit
number
default:"10"
Results per page (max: 100)
Field names are case-sensitive! Company fields use PascalCase (City, State, NICCode), GST fields use mixed case (state, Status, TaxpayerType).
curl -X POST https://api.finscreener.in/api/screener/search \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "State == '\''Maharashtra'\'' AND paidUpCapital > 5000000",
    "type": "company",
    "page": 1,
    "limit": 10
  }'

{
  "results": [
    {
      "CIN": "L17110MH1973PLC019786",
      "companyName": "RELIANCE INDUSTRIES LIMITED",
      "State": "Maharashtra",
      "City": "Mumbai",
      "paidUpCapital": 6766000000,
      "llpStatus": "Active"
    }
  ],
  "total": 1523,
  "page": 1,
  "pages": 153
}