Director Master Data

Director Identification Number (DIN) is a unique identifier for Company Director. Businesses can do directors' KYC using Sandbox API.

API Pricing Image

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 Endpoint  Contact Us  Free Trial

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
cin/fcrnstringCorporate Identification Number or Foreign Company Registration NumberU12300GJ2015PTC123456
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

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.

VersionDescriptionEndpoint
1.0This is the first version of the APIAPI Endpoint

Refer to our versioning policies here