curl --request POST \
--url https://api.sandbox.co.in/mca/company/master-data/search \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"@entity": "in.co.sandbox.kyc.mca.master_data.request",
"id": "<string>",
"consent": "<string>",
"reason": "<string>"
}
'{
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
"data": {
"@entity": "in.co.sandbox.kyc.mca.company",
"company_master_data": {
"@entity": "in.co.sandbox.kyc.mca.company.master_data",
"company_category": "Company limited by Shares",
"email_id": "john@doe.com",
"class_of_company": "Private",
"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",
"active_compliance": "ACTIVE Compliant",
"rd_region": "RD South East Region",
"balance_sheets": [
{}
],
"annual_returns": [
{}
]
},
"charges": [
{
"@entity": "in.co.sandbox.kyc.mca.company.charges",
"date_of_creation": "06/02/2019",
"date_of_modification": "-",
"charge_amount": "2000000000",
"status": "Closed"
}
],
"directors/signatory_details": [
{
"@entity": "in.co.sandbox.kyc.mca.company.directors_signatory_details",
"end_date": "-",
"din/pan": "99999999",
"begin_date": "09/06/2017",
"designation": "Director",
"name": "JOHN DOE"
}
]
}
}API takes in the Corporate Identification Number (CIN) to identify and retrieve basic information about the company.
curl --request POST \
--url https://api.sandbox.co.in/mca/company/master-data/search \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"@entity": "in.co.sandbox.kyc.mca.master_data.request",
"id": "<string>",
"consent": "<string>",
"reason": "<string>"
}
'{
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
"data": {
"@entity": "in.co.sandbox.kyc.mca.company",
"company_master_data": {
"@entity": "in.co.sandbox.kyc.mca.company.master_data",
"company_category": "Company limited by Shares",
"email_id": "john@doe.com",
"class_of_company": "Private",
"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",
"active_compliance": "ACTIVE Compliant",
"rd_region": "RD South East Region",
"balance_sheets": [
{}
],
"annual_returns": [
{}
]
},
"charges": [
{
"@entity": "in.co.sandbox.kyc.mca.company.charges",
"date_of_creation": "06/02/2019",
"date_of_modification": "-",
"charge_amount": "2000000000",
"status": "Closed"
}
],
"directors/signatory_details": [
{
"@entity": "in.co.sandbox.kyc.mca.company.directors_signatory_details",
"end_date": "-",
"din/pan": "99999999",
"begin_date": "09/06/2017",
"designation": "Director",
"name": "JOHN DOE"
}
]
}
}JWT access token
API key for identification
API version
entity name
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
Consent of the end-user to get their information for verification purposes. Possible values: Y and y
Purpose for which the user has given their consent.
200 - OK
200
1614696176218
"611335dc-8be4-40d1-8438-b86526462939"
Show child attributes
"in.co.sandbox.kyc.mca.company"
Show child attributes
"in.co.sandbox.kyc.mca.company.master_data"
"Company limited by Shares"
"john@doe.com"
"Private"
"30/09/2019"
"123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 380015 IN"
"999999"
"100000"
"Unlisted"
"-"
"U12300GJ2017PTC123456"
"Non-govt company"
"100000"
"Active"
"RoC-Ahmedabad"
"31/03/2019"
"09/06/2017"
"JOHN DOE PRIVATE LIMITED"
"ACTIVE Compliant"
"RD South East Region"
Show child attributes
Show child attributes
"in.co.sandbox.kyc.mca.company.directors_signatory_details"
"-"
"99999999"
"09/06/2017"
"Director"
"JOHN DOE"
Was this page helpful?