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"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/company-filter",
params={
"company": "infosys",
"state": "Karnataka",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
companies = response.json()
{
"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
}
Advanced Filters
Filter Companies
Filter and search companies by various criteria
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"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/company-filter",
params={
"company": "infosys",
"state": "Karnataka",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
companies = response.json()
{
"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
string
required
Bearer token:
Bearer <access_token>Query Parameters
string
Filter by CIN (Corporate Identity Number)
string
Search by company name (partial match)
string
Filter by incorporation date start (YYYY-MM-DD)
string
Filter by incorporation date end (YYYY-MM-DD)
string
Filter by company type (Company, LLP, etc.)
string
Filter by class (Private, Public, etc.)
string
Filter by category (Limited by shares, etc.)
string
Filter by status (Active, Struck Off, etc.)
number
Filter by NIC main division code
string
Filter by NIC main division description
string
Filter by Regional Director name
string
Filter by ROC (Registrar of Companies) code
string
Filter by listing status
number
Filter by NIC industry code
string
Filter by NIC description
string
Filter by city
string
Filter by state
string
Filter by district
number
Filter by PIN code
string
Filter by country
number
default:"1"
Page number
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"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/company-filter",
params={
"company": "infosys",
"state": "Karnataka",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
companies = response.json()
{
"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
}