Skip to main content
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"

{
  "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

​
Authorization
string
required
Bearer token: Bearer <access_token>

​
Query Parameters

​
DIN
string
Filter by DIN (Director Identification Number)
​
firstName
string
Filter by first name
​
lastName
string
Filter by last name
​
middleName
string
Filter by middle name
​
directorDisqualified
string
Filter by disqualification status
​
gender
string
Filter by gender
​
residentOfIndia
string
Filter by India residency status
​
citizenOfIndia
string
Filter by Indian citizenship
​
contactNationalityCountry
string
Filter by nationality/country
​
dob_start
string
Date of birth range start (YYYY-MM-DD)
​
dob_end
string
Date of birth range end (YYYY-MM-DD)
​
state
string
Filter by state
​
district
string
Filter by district
​
country
string
Filter by country
​
postalCode
string
Filter by postal code
​
page
number
default:"1"
Page number
​
limit
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"

{
  "results": [
    {
      "DIN": "00001695",
      "firstName": "MUKESH",
      "lastName": "AMBANI",
      "gender": "Male",
      "citizenOfIndia": "Yes",
      "state": "Maharashtra"
    }
  ],
  "total_results": 5,
  "page": 1,
  "limit": 10
}