Skip to main content
GET
/
api
/
company
/
company-filter
curl -X GET "https://api.finscreener.in/api/company/company-filter?company=infosys&state=Karnataka&page=1&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "results": [
    {
      "CIN": "L85110KA1981PLC013115",
      "companyName": "INFOSYS LIMITED",
      "companyType": "Company",
      "classOfCompany": "Public",
      "llpStatus": "Active",
      "State": "Karnataka",
      "City": "Bangalore",
      "NICCode": 62011
    }
  ],
  "total_results": 15,
  "page": 1,
  "limit": 10
}
Filter companies based on multiple criteria including name, location, industry, incorporation date, and more.

Headers

Authorization
string
required
Bearer token: Bearer <access_token>

Query Parameters

CIN
string
Filter by CIN (Corporate Identity Number)
company
string
Search by company name (partial match)
dateOfIncorporation_start
string
Filter by incorporation date start (YYYY-MM-DD)
dateOfIncorporation_end
string
Filter by incorporation date end (YYYY-MM-DD)
companyType
string
Filter by company type (Company, LLP, etc.)
classOfCompany
string
Filter by class (Private, Public, etc.)
companyCategory
string
Filter by category (Limited by shares, etc.)
llpStatus
string
Filter by status (Active, Struck Off, etc.)
mainDivision
number
Filter by NIC main division code
mainDivisionDescription
string
Filter by NIC main division description
rdName
string
Filter by Regional Director name
ROCCode
string
Filter by ROC (Registrar of Companies) code
listed
string
Filter by listing status
NICCode
number
Filter by NIC industry code
NICDesc
string
Filter by NIC description
city
string
Filter by city
state
string
Filter by state
district
string
Filter by district
pincode
number
Filter by PIN code
country
string
Filter by country
page
number
default:"1"
Page number
limit
number
default:"10"
Results per page (max: 100)
curl -X GET "https://api.finscreener.in/api/company/company-filter?company=infosys&state=Karnataka&page=1&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "results": [
    {
      "CIN": "L85110KA1981PLC013115",
      "companyName": "INFOSYS LIMITED",
      "companyType": "Company",
      "classOfCompany": "Public",
      "llpStatus": "Active",
      "State": "Karnataka",
      "City": "Bangalore",
      "NICCode": 62011
    }
  ],
  "total_results": 15,
  "page": 1,
  "limit": 10
}