CIN Details

Retrieve detailed company information using a CIN (Corporate Identification Number) from the Ministry of Corporate Affairs registry, including directors, registration details, capital, and compliance status.

Endpoint

POST /vas-api/v1/cin-details

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN
Content-Type	string	Yes	application/json

Body parameters

Field	Type	Required	Description	Example
cin	string	Yes	21-character Corporate Identification Number	U72900MH2017PTC295173

Example request

curl

curl -X POST https://api.api4business.com/vas-api/v1/cin-details \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cin": "U72900MH2017PTC295173"}'

Python

import requests

response = requests.post(
  "https://api.api4business.com/vas-api/v1/cin-details",
  headers={
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  json={"cin": "U72900MH2017PTC295173"}
)
print(response.json())

Node.js

const response = await fetch(
  "https://api.api4business.com/vas-api/v1/cin-details",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ cin: "U72900MH2017PTC295173" })
  }
);
console.log(await response.json());

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/v1/cin-details"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"cin\": \"U72900MH2017PTC295173\"}"))
  .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

Success (200)

Field	Type	Description
ok	boolean	true if successful
responseCode	number	HTTP status code
message	string	Status message
body.cin	string	The CIN that was queried
body.companyName	string	Registered company name
body.companyStatus	string	MCA status (Active, Struck Off, Under Process of Striking off)
body.companyType	string	Entity type (Company)
body.class	string	Company class (Private, Public)
body.category	string	Category (e.g., Company limited by shares)
body.subCategory	string	Sub-category (e.g., Non-government company)
body.dateOfIncorporation	string	Date of incorporation (YYYY-MM-DD)
body.authorisedCapital	string	Authorised capital in INR
body.paidUpCapital	string	Paid-up capital in INR
body.registeredAddress	string	Full registered office address
body.pan	string	PAN linked to the company
body.complianceStatus	string	MCA compliance status (e.g., ACTIVE Compliant)
body.directors	array	List of directors with name, DIN, designation, and appointment date

Example response

{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": {
    "cin": "U72900MH2017PTC295173",
    "companyName": "SAMPLE SOLUTIONS PRIVATE LIMITED",
    "companyStatus": "Active",
    "companyType": "Company",
    "class": "Private",
    "category": "Company limited by shares",
    "subCategory": "Non-government company",
    "dateOfIncorporation": "2017-05-22",
    "authorisedCapital": "10000000",
    "paidUpCapital": "3504430",
    "registeredAddress": "Floor 2, Commercial Complex, Mumbai, Maharashtra, India, 400070",
    "pan": "ABCDE1234F",
    "complianceStatus": "ACTIVE Compliant",
    "directors": [
      {
        "name": "SAMPLE DIRECTOR",
        "din": "06683575",
        "designation": "Director",
        "dateOfAppointment": "22/05/2017"
      }
    ]
  }
}

Response headers

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid CIN	Check CIN is 21 characters in the correct MCA format
400	400	Invalid Request	Verify JSON body contains cin field
401	401	Invalid Credentials	Access token expired or invalid
429	429	Quota Violation	Rate limit exceeded — retry with backoff
500	500	Internal Server Error	Retry after 1-5 seconds
503	503	Service Not Available	MCA service temporarily down — retry

Related

• PAN to CIN — Find CIN from a PAN
• MSME Details — Check MSME registration
• Company Verification Overview
• Error Handling Guide