# MCA Status API

This API will take Corporate Identification Number and connect with MCA API to get
\
data.

{% tabs %}
{% tab title="MCA Status API" %}

<table><thead><tr><th width="170">Name</th><th>Description</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td><a href="https://api-platform.mastersindia.co/api/v2/sbt/MCA/">https://api-platform.mastersindia.co/api/v2/sbt/MCA/</a></td></tr><tr><td><strong>Method Type</strong></td><td>POST</td></tr><tr><td><strong>Post Parameters (JSON Format)</strong></td><td>--header 'Content-Type: application/json'<br>--header 'Authorization: Bearer <br>--header 'Accept: application/json'<br>--data-raw '{ "cin":"L17110MH1973PLC019786" }'</td></tr><tr><td><strong>Success Response</strong></td><td><p>In case corporate identification number exist</p><pre class="language-json"><code class="lang-json">```json
{
    "response": [
        {
            "response": {
                "cin": "L72900MH2000PLC128943",
                "companyName": "IRIS BUSINESS SERVICES LIMITED",
                "companyStatus": "Active",
                "email": "cs@irisbusiness.com",
                "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"
}
```
</code></pre></td></tr><tr><td></td><td><p>In case of invalid format</p><ol><li>Invalid corporate identification number</li></ol><pre><code>"response": null, 
"error": "true", 
"code": "400", 
"message": "Data format failed OR wrong value entered at:  cin. Format should follow ^([L|U]{1})([0
</code></pre><p>9]{5})([A-Za-z]{2})([0-9]{4})([A-Za-z]{3})([0-9]{6})$
<br>}</p></td></tr><tr><td></td><td><p>b) In case of CIN does not exist in GST system</p><p>{ "response": [ { "response": { "error": "record_not_found", "error_description": "No record found" }, "responseStatus": "ERROR" } ], "error": "false", "code": "200", "message": "Success" }</p></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

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.