DIN Verification — Director Details Lookup
Verify a Director Identification Number (DIN) and retrieve the director's name, associated companies, and appointment details.
curl -X GET "https://production.deepvue.tech/v1/verification/mca/din?id_number=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://production.deepvue.tech/v1/verification/mca/din?id_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/mca/din?id_number=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://production.deepvue.tech/v1/verification/mca/din?id_number=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/mca/din?id_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1738236706189,
"transaction_id": "1e3f75a8-337f-4054-9b38-e8047c02b6ad",
"data": {
"director_data": {
"din": "00000001",
"name": "RATAN NAVAL TATA"
},
"company_data": [
{
"end_date": "-",
"designation": "Director",
"company_name": "RNT ASSOCIATES PRIVATE LIMITED",
"begin_date": "05/03/2009",
"cin/fcrn": "U74990MH2009PTC190764"
}
],
"llp_data": [
{
"end_date": "-",
"llp_name": "AVANTI CAPITAL ADVISORS LLP",
"designation": "Designated Partner",
"begin_date": "09/04/2017",
"llpin/fllpin": "AAJ-1011"
}
]
}
}
{
"code": 200,
"timestamp": 1738236904562,
"transaction_id": "24ee4b02-8fd8-4194-b6c9-80878920fd36",
"message": "DIN Entered does not match MCA Records, Please enter a Valid DIN."
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}
{
"detail": "Internal Server Error"
}
/v1/verification/mca/din
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
Overview
The DIN Verification API enables you to retrieve director master data using a Director Identification Number. This service provides verification information related to a given DIN, facilitating validation crucial for business operations and regulatory compliance.
The endpoint retrieves director identification details from the Ministry of Corporate Affairs (MCA) database, returning associated director information along with linked company and Limited Liability Partnership (LLP) data.
Successful verification returns:
- Director Data: DIN and director name
- Company Data: Associated companies with CIN/FCRN, designation, and tenure dates
- LLP Data: Associated partnerships with LLPIN/FLLPIN, designation, and tenure dates
When a DIN does not match MCA records, the API returns a 200 status code with a message indicating an invalid DIN rather than a standard error code, allowing applications to distinguish between genuine verification failures and system errors.
Last updated 4 weeks ago
Built with Documentation.AI