Skip to content

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 ​

HeaderTypeRequiredDescription
AuthorizationstringYesBearer YOUR_ACCESS_TOKEN
Content-TypestringYesapplication/json

Body parameters ​

FieldTypeRequiredDescriptionExample
cinstringYes21-character Corporate Identification NumberU72900MH2017PTC295173

Example request ​

bash
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())
javascript
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) ​

FieldTypeDescription
okbooleantrue if successful
responseCodenumberHTTP status code
messagestringStatus message
body.cinstringThe CIN that was queried
body.companyNamestringRegistered company name
body.companyStatusstringMCA status (Active, Struck Off, Under Process of Striking off)
body.companyTypestringEntity type (Company)
body.classstringCompany class (Private, Public)
body.categorystringCategory (e.g., Company limited by shares)
body.subCategorystringSub-category (e.g., Non-government company)
body.dateOfIncorporationstringDate of incorporation (YYYY-MM-DD)
body.authorisedCapitalstringAuthorised capital in INR
body.paidUpCapitalstringPaid-up capital in INR
body.registeredAddressstringFull registered office address
body.panstringPAN linked to the company
body.complianceStatusstringMCA compliance status (e.g., ACTIVE Compliant)
body.directorsarrayList of directors with name, DIN, designation, and appointment date

Example response ​

json
{
  "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 ​

HeaderDescription
x-request-idUnique request identifier — log this for debugging and support

Error responses ​

StatusError CodeMessageResolution
400400Invalid CINCheck CIN is 21 characters in the correct MCA format
400400Invalid RequestVerify JSON body contains cin field
401401Invalid CredentialsAccess token expired or invalid
429429Quota ViolationRate limit exceeded — retry with backoff
500500Internal Server ErrorRetry after 1-5 seconds
503503Service Not AvailableMCA service temporarily down — retry

Released under the API4Business Terms of Service