> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finscreener.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Filter Directors

> Filter and search directors by various criteria

Filter directors based on multiple criteria including name, location, nationality, and more.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## Query Parameters

<ParamField query="DIN" type="string">
  Filter by DIN (Director Identification Number)
</ParamField>

<ParamField query="firstName" type="string">
  Filter by first name
</ParamField>

<ParamField query="lastName" type="string">
  Filter by last name
</ParamField>

<ParamField query="middleName" type="string">
  Filter by middle name
</ParamField>

<ParamField query="directorDisqualified" type="string">
  Filter by disqualification status
</ParamField>

<ParamField query="gender" type="string">
  Filter by gender
</ParamField>

<ParamField query="residentOfIndia" type="string">
  Filter by India residency status
</ParamField>

<ParamField query="citizenOfIndia" type="string">
  Filter by Indian citizenship
</ParamField>

<ParamField query="contactNationalityCountry" type="string">
  Filter by nationality/country
</ParamField>

<ParamField query="dob_start" type="string">
  Date of birth range start (YYYY-MM-DD)
</ParamField>

<ParamField query="dob_end" type="string">
  Date of birth range end (YYYY-MM-DD)
</ParamField>

<ParamField query="state" type="string">
  Filter by state
</ParamField>

<ParamField query="district" type="string">
  Filter by district
</ParamField>

<ParamField query="country" type="string">
  Filter by country
</ParamField>

<ParamField query="postalCode" type="string">
  Filter by postal code
</ParamField>

<ParamField query="page" type="number" default="1">
  Page number
</ParamField>

<ParamField query="limit" type="number" default="10">
  Results per page (max: 100)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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"
  ```

  ```python Python theme={null}
  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()
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "results": [
      {
        "DIN": "00001695",
        "firstName": "MUKESH",
        "lastName": "AMBANI",
        "gender": "Male",
        "citizenOfIndia": "Yes",
        "state": "Maharashtra"
      }
    ],
    "total_results": 5,
    "page": 1,
    "limit": 10
  }
  ```
</ResponseExample>