Fetch Company Details
getFetch Company Details
get
https://api.sandbox.co.in/mca/companies/:id
Fetch companies details using CIN or LLPIN
Request
Response
Request
Path Parameters
id
required
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
Headers
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
required
string
​
Query Parameters
consent
required
string
Consent of the end-user to get their information for verification purposes. Possible values: Y and y
reason
required
string
Purpose for which the user has given their consent. Min length: 20 characters
Response
200: OK
CIN
LLPIN
CIN
{"data": {"company_master_data": {"company_category": "Company limited by Shares","email_id": "[email protected]","class_of_company": "Private","number_of_members(applicable_in_case_of_company_without_share_capital)": "0","address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintained": "-","date_of_last_agm": "30/09/2019","registered_address": "123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 380015 IN","registration_number": "999999","paid_up_capital(rs)": "100000","whether_listed_or_not": "Unlisted","suspended_at_stock_exchange": "-","cin": "U12300GJ2017PTC123456","company_subcategory": "Non-govt company","authorised_capital(rs)": "100000","company_status(for_efiling)": "Active","roc_code": "RoC-Ahmedabad","date_of_balance_sheet": "31/03/2019","date_of_incorporation": "09/06/2017","company_name": "JOHN DOE PRIVATE LIMITED"},"charges": [],"directors/signatory_details": [{"end_date": "-","din/pan": "99999999","begin_date": "09/06/2017","surrendered_din": "","name": "JOHN DOE"}]},"code": 200,"timestamp": 1614696176218,"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"}
LLPIN
{"data": {"charges": [],"directors/signatory_details": [{"end_date": "-","surrendered_din": "","din/pan": "99963999","begin_date": "31/03/2010","name": "JANE DOE"},{"end_date": "-","surrendered_din": "","din/pan": "99967999","begin_date": "31/03/2010","name": "JACK DOE"}],"llp_master_data": {"email_id": "[email protected]","registered_address": "1234, WILSON GARDEN BANGALORE Bangalore KA 560027 IN","date_of_last_financial_year_end_date_for_which_annual_return_filed": "31/03/2019","date_of_last_financial_year_end_date_for_which_statement_of_accounts_and_solvency_filed": "31/03/2019","main_division_of_business_activity_to_be_carried_out_in_india": "74","previous_firm/_company_details,_if_applicable": "","llpin": "XXX-0123","roc_code": "RoC-Bangalore","number_of_designated_partners": "2","date_of_incorporation": "24/04/2009","llp_name": "JANE DOE CONSULTING LLP","total_obligation_of_contribution": "15000","llp_status": "Active","description_of_main_division": "Other Business Activities","number_of_partners": "0"}},"code": 200,"timestamp": 1614696176218,"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"}
422: Unprocessable Entity
No records found
Invalid pattern
No records found
{"code": 422,"message": "Entered CIN/LLPIN/FLLPIN/FCRN is not found. Please enter valid details.","timestamp": 1614696176218,"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"}
Invalid pattern
​{"code": 422,"message": "CIN/FCRN/LLPIN/FLLPIN must be of the pattern [ADDDDDAADDDDAAADDDDDD] for CIN, [FDDDDD] for FCRN, [AAA-DDDD] for LLPIN and [FAAA-DDDD] for FLLPIN where A is an alphabet, D is a digit (0-9) and F is a literal F","timestamp": 1614696176218,"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"}
JWT Authorization token can be obtained by calling the Authenticate API
cURL
Java
Node.js
python
cURL
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'
Java
OkHttpClient client = new OkHttpClient().newBuilder().build();Request request = new Request.Builder().url("https://api.sandbox.co.in/mca/companies/U12300GJ2017PTC123456?consent=Y&reason=For GST registration").method("GET", null).addHeader("Authorization", "eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw").addHeader("x-api-key", "key_live_Ade**************************Uxs").addHeader("x-api-version", "3.4.0").build();Response response = client.newCall(request).execute();
Node.js
var https = require('follow-redirects').https;var fs = require('fs');​var options = {'method': 'GET','hostname': 'api.sandbox.co.in','path': '/mca/companies/U12300GJ2017PTC123456?consent=Y&reason=For%20GST%20registration','headers': {'Authorization': 'eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw','x-api-key': 'key_live_Ade**************************Uxs','x-api-version': '3.4.0'},'maxRedirects': 20};​var req = https.request(options, function (res) {var chunks = [];​res.on("data", function (chunk) {chunks.push(chunk);});​res.on("end", function (chunk) {var body = Buffer.concat(chunks);console.log(body.toString());});​res.on("error", function (error) {console.error(error);});});​req.end();
python
import requests​url = "https://api.sandbox.co.in/mca/companies/U12300GJ2017PTC123456?consent=Y&reason=For GST registration"​payload={}headers = {'Authorization': 'eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw','x-api-key': 'key_live_Ade**************************Uxs','x-api-version': '3.4.0'}​response = requests.request("GET", url, headers=headers, data=payload)​print(response.text)
Last updated 2 months ago