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

FieldTypeRequiredDescription
dinstringYesDirector 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

FieldTypeDescription
dinstringThe DIN that was checked.
namestringDirector's name.
father_namestringDirector's father's name.
dobstringDirector's date of birth.
designationstringCurrent designation.
date_of_appointmentstringDate of appointment.
addressstringDirector's address.
split_addressobjectThe director's address broken into parts.
split_address.districtarrayDistrict name, as a list.
split_address.statearrayState name, as a list.
split_address.cityarrayCity name, as a list.
split_address.pincodestringSix-digit pincode.
split_address.countryarrayCountry name, as a list.
split_address.address_linestringStreet-level part of the address.
whether_dsc_registeredstringWhether a digital signature certificate is registered.
dsc_expiry_datestringDate the digital signature certificate expires.
no_of_companiesstringNumber of companies the director is associated with.
list_of_companiesarrayThe companies the director is associated with.
list_of_llpsarrayThe 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.