New contracts for MCA APIs

We have deployed new API contracts for MCA APIs. Consequently, the previous contracts have been deprecated.

API Name	New Contracts	Deprecated Contracts
Company Master Data	{sandbox_host}/mca/company/master-data/search	{sandbox_host}/mca/companies/:id
Director Master Data	{sandbox_host}/mca/director/master-data/search	{sandbox_host}/mca/directors/:din

API contracts have changed as per our thought-process about which you can read here

Changes in the API request

Company Master Data API

curl --request POST \
     --url https://api.sandbox.co.in/mca/company/master-data/search \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "@entity": "in.co.sandbox.kyc.mca.master_data.request",
  "id": "U12345AB1234ABC123456",
  "consent": "y",
  "reason": "for KYC"
}
'

curl --request GET \
     --url 'https://api.sandbox.co.in/mca/companies/U12345AB1234ABC123456?consent=y&reason=for%20KYC' \
     --header 'accept: application/json'

Director Master Data API

curl --request POST \
     --url https://api.sandbox.co.in/mca/director/master-data/search \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "@entity": "in.co.sandbox.kyc.mca.master_data.request",
  "id": "9999999",
  "reason": "for KYC",
  "consent": "y"
}
'

curl --request GET \
     --url 'https://api.sandbox.co.in/mca/directors/9999999?consent=y&reason=for%20KYC' \
     --header 'accept: application/json'

Changes in the API response

Company Master Data API

The following Keys have been added

rd_region
balance_sheets array consisting of:
- date_of_filing
- financial_year
annual_returns array consisting of:
- date_of_filing
- financial_year
status_under_cirp (for LLPINs),
llp_strike_off/_amalgamated_date (for LLPINs),
designation (for directors)

The following keys have been removed:

asset_under_charge
number_of_members(applicable_in_case_of_company_without_share_capital)

You can compare the response as per the old and new contract below:

For CINs:

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "data": {
    "company_master_data": {
      "@entity": "in.co.sandbox.kyc.mca.company.master_data",
      "company_category": "Company limited by Shares",
      "email_id": "[email protected]",
      "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"
      }
    ]
  }
}

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "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": "U12345AB1234ABC123456",
      "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"
      }
    ]
  }
}

For LLPINs:

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "data": {
    "llp_master_data": {
      "@entity": "in.co.sandbox.kyc.mca.llp.master_data",
      "email_id": "[email protected]",
      "registered_address": "1234, WILSON GARDEN BANGALORE Bangalore KA 560027 IN",
      "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",
      "llp_strike_off/_amalgamated_date": "",
      "status_under_cirp": "",
      "rd_region": "RD South East Region"
    },
    "charges": [],
    "directors/signatory_details": [
      {
        "@entity": "in.co.sandbox.kyc.mca.llp.directors_signatory_details",
        "end_date": "-",
        "designation": "Designated Partner",
        "din/pan": "99963999",
        "begin_date": "31/03/2010",
        "name": "JANE DOE"
      },
      {
        "@entity": "in.co.sandbox.kyc.mca.llp.directors_signatory_details",
        "end_date": "-",
        "designation": "Designated Partner",
        "din/pan": "99967999",
        "begin_date": "31/03/2010",
        "name": "JACK DOE"
      }
    ],
    "balance_sheets": [
      {
        "@entity": "in.co.sandbox.kyc.mca.llp.balance_sheet",
        "date_of_filing": "31/03/2023",
        "financial_year": "31/03/2023"
      },
      {
        "@entity": "in.co.sandbox.kyc.mca.llp.balance_sheet",
        "date_of_filing": "31/03/2022",
        "financial_year": "31/03/2022"
      }
    ],
    "annual_returns": [
      {
        "@entity": "in.co.sandbox.kyc.mca.llp.annual_return",
        "date_of_filing": "31/03/2023",
        "financial_year": "31/03/2023"
      }
    ]
  }
}

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "data": {
    "company_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": "ABC-1234",
      "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"
    },
    "charges": [],
    "directors/signatory_details": [
      {
        "end_date": "-",
        "surrendered_din": "",
        "din/pan": "8888888",
        "begin_date": "31/03/2010",
        "name": "JANE DOE"
      },
      {
        "end_date": "-",
        "surrendered_din": "",
        "din/pan": "9999999",
        "begin_date": "31/03/2010",
        "name": "JACK DOE"
      }
    ]
  }
}

Director Master Data API

We have added designation of the director and remove the active_complaince key.

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "data": {
    "director_data": {
      "@entity": "in.co.sandbox.kyc.mca.director",
      "din": "99999999",
      "name": "JOHN DOE"
    },
    "llp_data": [
      {
        "@entity": "in.co.sandbox.kyc.mca.director.llp_data",
        "end_date": "-",
        "company_name": "JOHN DOE PRIVATE LIMITED",
        "designation": "Director",
        "begin_date": "19/03/2015",
        "llpin/fllpin": "ABC-1234"
      }
    ],
    "company_data": [
      {
        "@entity": "in.co.sandbox.kyc.mca.director.company_data",
        "end_date": "-",
        "company_name": "JOHN DOE PRIVATE LIMITED",
        "designation": "Director",
        "begin_date": "19/03/2015",
        "cin/fcrn": "U12300GJ2015PTC123456"
      },
      {
        "@entity": "in.co.sandbox.kyc.mca.director.company_data",
        "end_date": "-",
        "designation": "Director",
        "company_name": "JD PRIVATE LIMITED",
        "begin_date": "09/06/2017",
        "cin/fcrn": "U12300GJ2017PTC123456"
      }
    ]
  }
}

{
  "code": 200,
  "timestamp": 1614696176218,
  "transaction_id": "611335dc-8be4-40d1-8438-b86526462939",
  "data": {
    "llp_data": [],
    "company_data": [
      {
        "end_date": "-",
        "active_compliance": "ACTIVE compliant",
        "company_name": "JOHN DOE PRIVATE LIMITED",
        "begin_date": "19/03/2015",
        "cin/fcrn": "U12300GJ2015PTC123456"
      },
      {
        "end_date": "-",
        "active_compliance": "ACTIVE compliant",
        "company_name": "JD PRIVATE LIMITED",
        "begin_date": "09/06/2017",
        "cin/fcrn": "U12300GJ2017PTC123456"
      }
    ],
    "director_data": {
      "din": "79934699",
      "name": "JOHN DOE"
    }
  }
}

Deprecation of old contracts

The old contracts have been deprecated and will be discontinued soon. Timelines will be communicated.