Search Company

API reference

curl -X POST "https://__mock__/verification/v2/mca/search-company" \  -H "Content-Type: application/json" \  -d '{    "company_name": "string"  }'

{
  "companies": [
    {
      "company_name": "string",
      "cin": "string",
      "status": "string"
    }
  ]
}

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

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

{
  "error": "string"
}

Overview

Call POST /verification/v2/mca/search-company from your backend with Authorization: Bearer <token> and JSON company_name (required). On 200 OK, companies array entries include company_name, cin, and status so you can pick the right CIN for Get Company Master Data.

Key features

• Disambiguation: Name search before a CIN-scoped master pull.
• Structured list for UI pickers.

Implementation

Step 1: Call from your backend

POST /verification/v2/mca/search-company HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json

{
  "company_name": "Example Private Limited"
}

Step 2: Select CIN

Pass the chosen cin into the master-data GET endpoint.

Error handling

Benefits

• Faster KYB when the user types a legal name instead of a CIN.

Next steps

• Get Company Master Data
• Verification API index