curl -X GET "https://api.finscreener.in/api/company/director-filter?firstName=Mukesh&state=Maharashtra&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/director-filter",
params={
"firstName": "Mukesh",
"state": "Maharashtra",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
directors = response.json()
{
"results": [
{
"DIN": "00001695",
"firstName": "MUKESH",
"lastName": "AMBANI",
"gender": "Male",
"citizenOfIndia": "Yes",
"state": "Maharashtra"
}
],
"total_results": 5,
"page": 1,
"limit": 10
}
Advanced Filters
Filter Directors
Filter and search directors by various criteria
GET
/
api
/
company
/
director-filter
curl -X GET "https://api.finscreener.in/api/company/director-filter?firstName=Mukesh&state=Maharashtra&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/director-filter",
params={
"firstName": "Mukesh",
"state": "Maharashtra",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
directors = response.json()
{
"results": [
{
"DIN": "00001695",
"firstName": "MUKESH",
"lastName": "AMBANI",
"gender": "Male",
"citizenOfIndia": "Yes",
"state": "Maharashtra"
}
],
"total_results": 5,
"page": 1,
"limit": 10
}
Filter directors based on multiple criteria including name, location, nationality, and more.
Headers
string
required
Bearer token:
Bearer <access_token>Query Parameters
string
Filter by DIN (Director Identification Number)
string
Filter by first name
string
Filter by last name
string
Filter by middle name
string
Filter by disqualification status
string
Filter by gender
string
Filter by India residency status
string
Filter by Indian citizenship
string
Filter by nationality/country
string
Date of birth range start (YYYY-MM-DD)
string
Date of birth range end (YYYY-MM-DD)
string
Filter by state
string
Filter by district
string
Filter by country
string
Filter by postal code
number
default:"1"
Page number
number
default:"10"
Results per page (max: 100)
curl -X GET "https://api.finscreener.in/api/company/director-filter?firstName=Mukesh&state=Maharashtra&page=1&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import requests
response = requests.get(
"https://api.finscreener.in/api/company/director-filter",
params={
"firstName": "Mukesh",
"state": "Maharashtra",
"page": 1,
"limit": 10
},
headers={"Authorization": f"Bearer {token}"}
)
directors = response.json()
{
"results": [
{
"DIN": "00001695",
"firstName": "MUKESH",
"lastName": "AMBANI",
"gender": "Male",
"citizenOfIndia": "Yes",
"state": "Maharashtra"
}
],
"total_results": 5,
"page": 1,
"limit": 10
}