About

The API takes in id (CIN or LLPIN) and returns the details of the body corporate.
The Details are fetched from the MCA Master Data

Definition

Corporate Identification Number (CIN) is a unique 21-digit alphanumeric number provided to all companies registered in India.
The CIN is used to track all the aspects of the company. The CIN is therefore used to identify and retrieve basic information about the company.
Similar to CIN, LLPIN is the identification number for LLPs.
MCA has been enabled the public to access the master data of any company/LLP registered with the Registrar of Companies.
Master Data of a company/LLP is the registration information of the company/LLP. Hence, the master data will include detail such as registration date, address, company category, etc.
A master data of a company can be pulled up by using its CIN and LLPIN in the case of LLPs.

By knowing this information, you can

Verify claims by your clients or vendors by cross-checking the information from the MCA master data.
Automate the population of data when onboarding a company or LLP.

📘
Want to know more?! 📖
Check out the article on 💡 Learn by Quicko

HTTP Method	Resource	Description
GET	https://api.sandbox.co.in/mca/companies/{id}	Endpoint takes in CIN/LLPIN as a path parameter and returns Master Data of corresponding company/LLP

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

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`	Purpose for which the user has given their consent. Min length: 20 characters	for verifying company while onboarding on business

Param	Description	Example	Type
company_category	Company/LLP Category is displayed	Company limited by Shares	`string`
email_id	Email id of the company/LLP	[email protected]	`string`
class_of_company	Public, Private or other Class of company/LLP	Private	`string`
number_of_members(applicable_in_case_of_company_without_share_capital)	Number of Members of the company/LLP	0	`string`
address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintained	Other Address of the Company/LLP		`string`
date_of_last_agm	Date of Last Annual	30/09/2019	`string`
registered_address	Registered Address of Company/LLP	123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 80015 IN	`string`
registration_number	Registration number of Company/LLP	999999	`string`
paid_up_capital(rs)	Paid up capital of company	100000	`string`
whether_listed_or_not	Whether company is listed or not in Stock Exchange	Unlisted	`string`
suspended_at_stock_exchange	Whether company is suspended at a stock exchange or not		`string`
cin	CIN of the Company	U12300GJ2017PTC123456	`string`
company_subcategory	Subcategory of company	Non-govt company	`string`
authorised_capital(rs)	Authorised capital of company	100000	`string`
company_status(for_efiling)	Efiling status of the Company	Active	`string`
roc_code	ROC Code of ROC where Company is registered	RoC-Ahmedabad	`string`
date_of_balance_sheet	Balance Sheet Date	31/03/2019	`string`
date_of_incorporation	Date of incorporation of the Company	09/06/2017	`string`
company_name	Name of the company	JOHN DOE PRIVATE LIMITED	`string`