API reference / Business / KYB
Director search by DIN
Director details and company associations from the MCA record for an 8-digit DIN.
POST
/v1/business/director- Authentication
- Bearer token
- Scope
kyc:verify
Request body
| Field | Type | Required | Description |
|---|---|---|---|
din | string | Yes | Director identification number, exactly 8 digits. Spaces and hyphens are ignored. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/business/director' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"din": "03625470"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"din": "03625470",
"name": "ASHA RAO",
"father_name": "RAMESH RAO",
"dob": "1990-08-17",
"designation": "Director",
"date_of_appointment": "2018-05-02",
"address": "12 Example Lane, Pune, Maharashtra, 411001",
"split_address": {
"district": [
"Pune"
],
"state": [
"Maharashtra"
],
"city": [
"Pune"
],
"pincode": "411001",
"country": [
"India"
],
"address_line": "12 Example Lane"
},
"whether_dsc_registered": "Yes",
"no_of_companies": "1",
"list_of_companies": [
{
"company_name": "EXAMPLE TRADERS PRIVATE LIMITED"
}
],
"list_of_llps": []
}
}Response fields
| Field | Type | Description |
|---|---|---|
din | string | The DIN that was checked. |
name | string | Director's name. |
father_name | string | Director's father's name. |
dob | string | Director's date of birth. |
designation | string | Current designation. |
date_of_appointment | string | Date of appointment. |
address | string | Director's address. |
split_address | object | The director's address broken into parts. |
split_address.district | array | District name, as a list. |
split_address.state | array | State name, as a list. |
split_address.city | array | City name, as a list. |
split_address.pincode | string | Six-digit pincode. |
split_address.country | array | Country name, as a list. |
split_address.address_line | string | Street-level part of the address. |
whether_dsc_registered | string | Whether a digital signature certificate is registered. |
dsc_expiry_date | string | Date the digital signature certificate expires. |
no_of_companies | string | Number of companies the director is associated with. |
list_of_companies | array | The companies the director is associated with. |
list_of_llps | array | The limited liability partnerships the director is associated with. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.