MCA Status API
Check whether a company is Active or not in the government database and the turnover of the company year-wise
This API will take Corporate Identification Number and connect with MCA API to get data.
Method Type
POST
Post Parameters (JSON Format)
--header 'Content-Type: application/json' --header 'Authorization: Bearer --header 'Accept: application/json' --data-raw '{ "cin":"L17110MH1973PLC019786" }'
Success Response
In case corporate identification number exist
```json
{
"response": [
{
"response": {
"cin": "L72900MH2000PLC128943",
"companyName": "IRIS BUSINESS SERVICES LIMITED",
"companyStatus": "Active",
"email": "[email protected]",
"financialAuditStatus": "YES",
"incorporationDate": "03/10/2000",
"registeredAddress": "T-231, Tower 2, 3rd Floor, International Infortech Park, Vashi Station Vashi MH 400703 IN",
"registeredContactNo": "",
"rocCode": "RoC-Mumbai",
"financialDetails": [
{
"profitLoss": " 6757000.00",
"year": "2022",
"turnOver": " 561519000.00"
},
{
"profitLoss": " 33255303.00",
"year": "2021",
"turnOver": " 530878129.00"
},
{
"profitLoss": " 15084880.00",
"year": "2020",
"turnOver": " 488822751.00"
}
]
},
"responseStatus": "SUCCESS"
}
],
"error": "false",
"code": "200",
"message": "Success"
}
```In case of invalid format
Invalid corporate identification number
"response": null,
"error": "true",
"code": "400",
"message": "Data format failed OR wrong value entered at: cin. Format should follow ^([L|U]{1})([09]{5})([A-Za-z]{2})([0-9]{4})([A-Za-z]{3})([0-9]{6})$ }
b) In case of CIN does not exist in GST system
{ "response": [ { "response": { "error": "record_not_found", "error_description": "No record found" }, "responseStatus": "ERROR" } ], "error": "false", "code": "200", "message": "Success" }
Status Code 200: corporate data response Status Code 400: Bad request (Invalid json syntax, invalid json key) Status Code 401 or 403: Unauthenticated or Unauthorized Status Code 500: Some internal server error occurred Status Code 502: Server is not responding.
Last updated
Was this helpful?