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
}