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

{
  "states": ["Maharashtra", "Karnataka", "Delhi", "Tamil Nadu", ...],
  "cities": ["Mumbai", "Bangalore", "Delhi", "Chennai", "Pune", ...],
  "nicCodes": [
    {"code": 62011, "description": "Computer programming activities"},
    {"code": 62012, "description": "Computer consultancy"},
    ...
  ],
  "companyTypes": ["Company", "LLP", "FLLPIN", "Society"],
  "companyStatus": ["Active", "Struck Off", "Under Liquidation", "Dormant"],
  "classOfCompany": ["Private", "Public", "One Person Company", "Government Company"]
}
Retrieve available filter options for company screening, including states, cities, NIC codes, and company types.

​
Headers

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Response

​
states
array
List of Indian states
​
cities
array
List of major cities
​
nicCodes
array
Available NIC industry codes with descriptions
​
companyTypes
array
Company type options (Company, LLP, etc.)
​
companyStatus
array
Status options (Active, Struck Off, etc.)
​
classOfCompany
array
Class options (Private, Public, OPC, etc.)
curl -X GET "https://api.finscreener.in/api/filters/companies" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "states": ["Maharashtra", "Karnataka", "Delhi", "Tamil Nadu", ...],
  "cities": ["Mumbai", "Bangalore", "Delhi", "Chennai", "Pune", ...],
  "nicCodes": [
    {"code": 62011, "description": "Computer programming activities"},
    {"code": 62012, "description": "Computer consultancy"},
    ...
  ],
  "companyTypes": ["Company", "LLP", "FLLPIN", "Society"],
  "companyStatus": ["Active", "Struck Off", "Under Liquidation", "Dormant"],
  "classOfCompany": ["Private", "Public", "One Person Company", "Government Company"]
}