---
title: "Company, LLP, or foreign company master data"
method: POST
path: "/kyc/mca/company-master-data/search"
tags: ["mca"]
---

# Company, LLP, or foreign company master data

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

## Request

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

Retrieve company, LLP, or foreign company master data from MCA using a CIN, LLPIN, or FCRN. The response returns a locked v1 public contract with a stable `company_master_data` block for the core registry record plus optional expansions for charges, principals, filings, annual returns, and balance sheets.

## Headers

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

## Request body

- CompanyMasterDataRequest
  - `identifier` string, required: CIN, LLPIN, or FCRN of the entity to be resolved.
  - `identifier_type` 'auto' | 'cin' | 'llpin' | 'fcrn': Hint for the identifier format. Use `auto` when unsure.
  - `include` string[]: Optional related datasets to expand in the response.

## Response `200`

Company, LLP, or foreign company master data retrieved successfully.

- CompanyMasterDataSearchResponse
  - `code` integer, required
  - `timestamp` integer, required
  - `transaction_id` string, uuid, required
  - `meta` ResponseMeta, required
    - `contract_version` 'v1', required
    - `requested_identifier` string, required
    - `resolved_identifier` string, required
    - `detected_identifier_type` 'cin' | 'llpin' | 'fcrn', required
    - `entity_type` 'company' | 'llp', required
    - `included_sections` string[], required
  - `data` CompanyMasterDataRecord, required
    - `company_master_data` CompanyMasterDataSummary, required
      - `entity_type` 'company' | 'llp'
      - `identifier` string
      - `identifier_type` 'cin' | 'llpin' | 'fcrn'
      - `cin` string
      - `llpin` string
      - `fcrn` string
      - `company_name` string
      - `company_status` string
      - `company_category` string
      - `company_subcategory` string
      - `class_of_company` string
      - `company_origin` string
      - `registration_number` string
      - `roc_code` string
      - `roc_name` string
      - `rd_name` string
      - `rd_region` string
      - `date_of_incorporation` string, date
      - `establishment_date` string, date
      - `registered_address` string
      - `registered_state` string
      - `email_id` string, email
      - `website` string
      - `main_division_code` string
      - `description_of_main_division` string
      - `authorised_capital_inr` string
      - `paid_up_capital_inr` string
      - `subscribed_capital_inr` string
      - `share_capital_flag` string
      - `maximum_number_of_members` string
      - `number_of_members` string
      - `listed_status` 'listed' | 'unlisted'
      - `suspended_at_stock_exchange` string
      - `date_of_balance_sheet` string, date
      - `date_of_last_agm` string, date
      - `active_compliance` string
      - `annual_returns` FilingSummary[]
        - `financial_year` string, required
        - `filed_on` string, date, required
      - `balance_sheets` FilingSummary[]
        - `financial_year` string, required
        - `filed_on` string, date, required
    - `charges` Charge[]
      - `charge_id` string
      - `srn` string
      - `charge_holder` string, required
      - `registered_name` string
      - `charge_amount_inr` string
      - `status` string, required
      - `date_of_creation` string, date, required
      - `date_of_modification` string, date
      - `date_of_satisfaction` string, date
      - `address` string
    - `principals` Principal[]
      - `name` string, required
      - `identifier` string
      - `designation` string, required
      - `category` string
      - `appointed_on` string, date, required
      - `ceased_on` string, date
      - `ceased` boolean
      - `disqualified` boolean
      - `email_masked` string
      - `mobile_masked` string
    - `filings` Filing[]
      - `dms_id` integer, required
      - `eform` string, required
      - `srn` string, required
      - `event_date` string, date, 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 company, LLP, or foreign company record was found.
- `500`: Unexpected internal error.
- `503`: An upstream registry dependency is temporarily unavailable.

---

[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)