Director Master Data
Director Identification Number (DIN) is a unique identifier for Company Director. Businesses can do directors' KYC using Sandbox API.
Overview
The API takes in din and returns the details of the Director
Problem
- Businesses need to KYC companies and their directors before conducting business with them.
- Company directors can resign or their KYC status can expire or their DIN can be deactivated due to non-compliance.
- Businesses can only verify one director at a time by visiting the MCA website.
Solution
- API to verify directors using Director Identification Number (DIN) in real-time
- Director details are fetched from the MCA Master Data
Endpoint
| HTTP Method | Resource |
|---|---|
GET | /mca/directors/:din |
Request
Follow the below guidelines to pass din, consent & reason for verification
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| din | string | 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 | string | Consent of the end-user to get their information for verification purposes. Possible values: Y and y | Y |
| reason | string | Indicate the purpose for verification. Min length: 20 characters | For KYC of the Director |
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 Environment Not Available
Response
| Param | Type | Description | Example |
|---|---|---|---|
| end_date | string | End of directorship at the company | - |
| active_compliance | string | Whether DIN is active or not | ACTIVE compliant |
| cin/fcrn | string | Corporate Identification Number or Foreign Company Registration Number | U12300GJ2015PTC123456 |
| company_name | string | Company the person is a director of | JOHN DOE PRIVATE LIMITED |
| begin_date | string | Start date of Directorship in the particular Company | 19/03/2015 |
| din | string | DIN of the Director | 99999999 |
| name | string | Name of the Director | JOHN DOE |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Director Master Data API is not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.
| Version | Description | Endpoint |
|---|---|---|
| 1.0 | This is the first version of the API | |
Refer to our versioning policies here
Updated about 2 months ago