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 MethodResource
GET/mca/directors/:din

API EndpointAPI Endpoint

Request

Follow the below guidelines to pass din, consent & reason for verification

Path Parameters

ParamTypeDescriptionExample
dinstring8-digit unique identification number, which is allotted by the central government to each individual who is a director of any company99999999

Query Parameters

ParamTypeDescriptionExample
consentstringConsent of the end-user to get their information for verification purposes. Possible values: Y and yY
reasonstringIndicate 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

ParamTypeDescriptionExample
end_datestringEnd of directorship at the company-
active_compliancestringWhether DIN is active or notACTIVE compliant
company_namestringCompany the person is a director ofJOHN DOE PRIVATE LIMITED
begin_datestringStart date of Directorship in the particular Company19/03/2015
dinstringDIN of the Director99999999
namestringName of the DirectorJOHN DOE