> ## 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.

# Director Details

> Get detailed director information by DIN

Retrieve comprehensive details for a director by their DIN (Director Identification Number).

<Warning>
  This endpoint is **rate limited** to 100 requests per day across all detail endpoints.
</Warning>

## Headers

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

## Query Parameters

<ParamField query="din" type="string" required>
  Director DIN (e.g., `00001695`)
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="DIN" type="string">Director Identification Number</ResponseField>
    <ResponseField name="Name" type="string">Full name</ResponseField>
    <ResponseField name="FatherName" type="string">Father's name</ResponseField>
    <ResponseField name="Nationality" type="string">Nationality</ResponseField>
    <ResponseField name="DateOfBirth" type="string">Date of birth</ResponseField>
    <ResponseField name="Address" type="string">Residential address</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="rate_limit" type="object">
  Rate limit information including remaining requests
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.finscreener.in/api/company/director-details?din=00001695" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.finscreener.in/api/company/director-details",
      params={"din": "00001695"},
      headers={"Authorization": f"Bearer {token}"}
  )
  director = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "DIN": "00001695",
      "Name": "MUKESH DHIRUBHAI AMBANI",
      "Nationality": "Indian",
      "Address": "Mumbai, Maharashtra",
      "companies": [
        {
          "CIN": "L17110MH1973PLC019786",
          "companyName": "RELIANCE INDUSTRIES LIMITED",
          "Designation": "Chairman and Managing Director",
          "dateOfAppointment": "2002-07-01",
          "dateOfCessation": null
        }
      ]
    },
    "rate_limit": {
      "remaining": 94,
      "limit": 100,
      "reset": "2026-03-21T00:00:00Z"
    }
  }
  ```
</ResponseExample>