Director Details
Overview
- The API takes in
dinand returns the details of the Director
Problem
- You wish to verify a director's claims
- At the same time, expired Director status or end of directorship of a director has MCA compliance requirements.
Solution
- Use this API to ask the relevant parties whether the compliance requirements are met or not.
- It can also help in verifying DIN/DPIN
- The Details are fetched from the MCA Master Data
Endpoint
HTTP Method | Resource |
|---|---|
| /mca/directors/:din |
Request
You need to pass din in your path parameter, while consent and reason need to be passed as query parameters.
Path Parameters
Param | Type | Description | Example |
|---|---|---|---|
din |
| 8-digit unique identification number, which is allotted by the central government to each individual who is a director of any company | 99999999 |
Query Parameters
Param | Type | Description | Example |
|---|---|---|---|
consent |
| Consent of the end-user to get their information for verification purposes. Possible values: Y and y | Y |
reason |
| Purpose for which the user has given their consent. Min length: 20 characters | For GST registration |
Once the values are added, Your curl will look something like this
curl --location --request GET 'https://api.sandbox.co.in/mca/directors/99999999?consent=Y&reason=For%20GST%20registration' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Test Data Not Available
Instead, input valid credentials along with
live_keyto use the API.
Note
The response below is for a Company. A similar response will be provided for LLPs that the DIN is associated with.
Response
Param | Type | Description | Example |
|---|---|---|---|
end_date |
| End of directorship at the company | |
active_compliance |
| Wether DIN is active or not | ACTIVE compliant |
company_name |
| Company the person is a director of | JOHN DOE PRIVATE LIMITED |
begin_date |
| Start date of Directorship in the particular Company | 19/03/2015 |
din |
| DIN of the Director | 99999999 |
name |
| Name of the Director | JOHN DOE |
Updated about 2 months ago