Get Company Master Data

API reference

curl -X GET "https://__mock__/verification/v2/mca/master-data/string"

{
  "company_name": "string",
  "cin": "string",
  "registration_date": "2019-08-24",
  "company_status": "string",
  "company_category": "string",
  "company_class": "string",
  "authorized_capital": 0,
  "paid_up_capital": 0,
  "registered_address": "string",
  "email": "string",
  "phone": "string"
}

{
  "detail": {},
  "message": "string"
}

{
  "detail": {},
  "message": "string"
}

{
  "error": "Company not found for the provided details"
}

{
  "error": "string"
}

Overview

Call GET /verification/v2/mca/master-data/{cin} from your backend with Authorization: Bearer <token>. Replace {cin} with the 21-character CIN. Use after Search Company when you only had a name first.

Key features

• KYB depth: Returns registration date, class, category, capital, and status fields as per OpenAPI.
• CIN as key: Stable identifier for ongoing monitoring.

Implementation

Step 1: Call from your backend

GET /verification/v2/mca/master-data/L12345MH2000PLC123456 HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>

Step 2: Use the response

Map company_name, company_status, and related fields into your risk and compliance systems.

Error handling

Benefits

• Single call for full MCA snapshot once you hold the CIN.

Next steps

• Search Company
• Verification API index