---
title: "Director master data"
method: POST
path: "/kyc/mca/director-master-data/search"
tags: ["mca"]
---

# Director master data

`POST /kyc/mca/director-master-data/search`

## Request

- Base URL: `https://api.qorpiq.com`
- URL: `https://api.qorpiq.com/kyc/mca/director-master-data/search`
- Auth: API key in header `x-api-key`

Retrieve director master data from MCA using a DIN. The response returns a locked v1 public contract with a stable `director_master_data` block for the core DIN record plus an optional normalized `appointments` expansion across companies and LLPs.

## Headers

- `x-api-version` string
- `Content-Type` 'application/json'

## Request body

- DirectorMasterDataRequest
  - `identifier` string, required: 8-digit Director Identification Number (DIN) of the director to be resolved.
  - `include` string[]: Optional related datasets to expand in the response.

## Response `200`

Director master data retrieved successfully.

- DirectorMasterDataSearchResponse
  - `code` integer, required
  - `timestamp` integer, required
  - `transaction_id` string, uuid, required
  - `meta` DirectorResponseMeta, required
    - `contract_version` 'v1', required
    - `requested_identifier` string, required
    - `resolved_identifier` string, required
    - `detected_identifier_type` 'din', required
    - `entity_type` 'director', required
    - `included_sections` string[], required
  - `data` DirectorMasterDataRecord, required
    - `director_master_data` DirectorMasterDataSummary, required
      - `entity_type` 'director'
      - `identifier` string
      - `identifier_type` 'din'
      - `din` string
      - `director_name` string
      - `father_name` string
      - `date_of_birth` string, date
      - `gender` string
      - `nationality` string
      - `address` string
      - `din_status` string
      - `email_masked` string
      - `mobile_masked` string
      - `total_appointments_count` integer
      - `current_appointments_count` integer
      - `past_appointments_count` integer
    - `appointments` DirectorAppointment[]
      - `entity_type` 'company' | 'llp', required
      - `identifier` string, required
      - `identifier_type` 'cin' | 'llpin' | 'fcrn', required
      - `entity_name` string, required
      - `entity_status` string
      - `designation` string, required
      - `category` string
      - `appointed_on` string, date
      - `ceased_on` string, date
      - `current` boolean, required
    - `source` SourceMetadata, required
      - `provider` string, required
      - `fetched_at` string, date-time, required
      - `normalized` boolean, required

## Other responses

- `400`: Request validation failed.
- `401`: Authentication failed.
- `402`: Balance too low for this call. Add money to your QorpIQ balance to continue (reason credit_balance_exhausted is kept for compatibility).
- `404`: No matching director record was found.
- `500`: Unexpected internal error.

---

[API](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api.md) · [All operations](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/revisions/5a9c792b6c06?raw)