Company Details
Overview
- The API takes in
id(CIN or LLPIN) and returns the details of the body corporate.
Problem
- To verify claims by your clients or vendors by cross-checking the information with the MCA master data.
Solution
- The CIN is used to track all the aspects of the company.
- Automate the population of data when onboarding a company or LLP.
- It can also help in verifying CIN/LLPIN
- The Details are fetched from the MCA Master Data
Endpoint
HTTP Method | Resource |
|---|---|
GET | /mca/companies/:id |
Request
You need to add id in your parameter while consent and reason are required query parameters
Path Parameters
Param | Type | Description | Example |
|---|---|---|---|
id |
| 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 Paramenters
Param | Type | Description | Example |
|---|---|---|---|
consent |
| Consent of the end-user to get their information for verification purposes. Possible values: Y and y | Y |
reason |
| Purpose for which the user has given their consent. Min length: 20 characters | For GST registration |
Once the values are added, Your curl will look something like this
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 Data Not Available
Instead, input valid credentials along with
live_keyto use the API.
Response
Param | Description | Example | Type |
|---|---|---|---|
company_category | Company/LLP Category is displayed | Company limited by Shares |
|
email_id | Email id of the company/LLP |
| |
class_of_company | Public, Private or other Class of company/LLP | Private |
|
number_of_members(applicable_in_case_of_company_without_share_capital) | Number of Members of the company/LLP | 0 |
|
address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintained | Other Address of the Company/LLP |
| |
date_of_last_agm | Date of Last Annual | 30/09/2019 |
|
registered_address | Registered Address of Company/LLP | 123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 80015 IN |
|
registration_number | Registration number of Company/LLP | 999999 |
|
paid_up_capital(rs) | Paid up capital of company | 100000 |
|
whether_listed_or_not | Whether company is listed or not in Stock Exchange | Unlisted |
|
suspended_at_stock_exchange | Whether company is suspended at a stock exchange or not |
| |
cin | CIN of the Company | U12300GJ2017PTC123456 |
|
company_subcategory | Subcategory of company | Non-govt company |
|
authorised_capital(rs) | Authorised capital of company | 100000 |
|
company_status(for_efiling) | Efiling status of the Company | Active |
|
roc_code | ROC Code of ROC where Company is registered | RoC-Ahmedabad |
|
date_of_balance_sheet | Balance Sheet Date | 31/03/2019 |
|
date_of_incorporation | Date of incorporation of the Company | 09/06/2017 |
|
company_name | Name of the company | JOHN DOE PRIVATE LIMITED |
|
Updated about 2 months ago