Filter Directors

Filter and search directors by various criteria

GET /api/company/director-filter

cURL

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"

Success

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

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"

Success

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