Company Master Data
Company Identification Number (CIN) is a unique identifier for Companies. Businesses can do company KYC using Sandbox API.
Overview
The API takes in id (CIN or LLPIN) and returns the details of the body corporate.
Problem
- Businesses need to KYC companies and their directors before conducting business with them.
- Companies can wind down or be blacklisted due to non-compliance.
- Businesses can only verify one company at a time by visiting the MCA website.
Solution
- API to verify companies using Company Identification Number (CIN) in real-time
- Company details are fetched from the MCA Master Data
Endpoint
| HTTP Method | Resource |
|---|---|
| GET | /mca/companies/:id |
Request
Follow the below guidelines to pass id, consent & reason for verification
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| id | string | 21 characters alpha-numeric unique identification code, which is allotted by the central government to each company or 7 characters alpha-numeric unique identification code issued to LLP | U12300GJ2017PTC123456 |
Query Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| consent | string | Consent of the end-user to get their information for verification purposes. Possible values: Y and y | Y |
| reason | string | Indicate the purpose for verification. Min length: 20 characters | For Company KYC |
Sample CURL request
curl --location -g --request GET 'https://api.sandbox.co.in/mca/companies/U12300GJ2017PTC123456?consent=Y&reason=For%20GST%20registration' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Test Environment Not Available
Response
| Param | Type | Description | Example |
|---|---|---|---|
| company_category | string | Company/LLP Category is displayed. Possible values are: Company limited by Shares,Company limited by guarantee,Unlimited company | Company limited by Shares |
| email_id | string | Email id of the company/LLP | [email protected] |
| class_of_company | string | Public, Private or other Class of company/LLP Possible values are: Private,Public,One person Company | Private |
| number_of_members(applicable_in_case_of_company_without_share_capital) | string | Number of Members of the company/LLP | 0 |
| address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintained | string | Other Address of the Company/LLP | - |
| date_of_last_agm | string | Date of Last Annual | 30/09/2019 |
| registered_address | string | Registered Address of Company/LLP | 123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 80015 IN |
| registration_number | string | Registration number of Company/LLP | 999999 |
| paid_up_capital(rs) | string | Paid up capital of company | 100000 |
| whether_listed_or_not | string | Whether company is listed or not in Stock Exchange Possible values are: Listed,Unlisted | Unlisted |
| suspended_at_stock_exchange | string | Whether company is suspended at a stock exchange or not | - |
| cin | string | CIN of the Company | U12300GJ2017PTC123456 |
| company_subcategory | string | Subcategory of company Possible values are: Union government company,State government company, Non-government company, Subsidiary of company incorporated outside India, Guarantee and association company | Non-govt company |
| authorised_capital(rs) | string | Authorised capital of company | 100000 |
| company_status(for_efiling) | string | Efiling status of the Company Possible values are: Active, Dormant, Dormant Under Section 455, Active In Progress, Amalgamated, Not Available for eFiling, Converted to LLP, Converted to LLP and Dissolved, Dissolved, Under Liquidation, Liquidated, Under Process of Striking Off, Strike Off, Captured | Active |
| roc_code | string | ROC Code of ROC where Company is registered | RoC-Ahmedabad |
| date_of_balance_sheet | string | Balance Sheet Date | 31/03/2019 |
| date_of_incorporation | string | Date of incorporation of the Company | 09/06/2017 |
| company_name | string | Name of the company | JOHN DOE PRIVATE LIMITED |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Company Master Data API is not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.
| Version | Description | Endpoint |
|---|---|---|
| 1.0 | This is the first version of the API | |
Refer to our versioning policies here
Updated 6 months ago