Company Master Data

Company Identification Number (CIN) is a unique identifier for Companies. Businesses can do company KYC using Sandbox API.

Overview

The API takes in id (CIN or LLPIN) and returns the details of the body corporate.

Problem

  • Businesses need to KYC companies and their directors before conducting business with them.
  • Companies can wind down or be blacklisted due to non-compliance.
  • Businesses can only verify one company at a time by visiting the MCA website.

Solution

  • API to verify companies using Company Identification Number (CIN) in real-time
  • Company details are fetched from the MCA Master Data

Endpoint

HTTP MethodResource
GET/mca/companies/:id

API EndpointAPI Endpoint

Request

Follow the below guidelines to pass id, consent & reason for verification

Path Parameters

ParamTypeDescriptionExample
idstring21 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 Parameters

ParamTypeDescriptionExample
consentstringConsent of the end-user to get their information for verification purposes.
Possible values: Y and y
Y
reasonstringIndicate the purpose for verification.
Min length: 20 characters
For Company KYC

Sample CURL request

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 Environment Not Available

Response

ParamDescriptionExampleType
company_categoryCompany/LLP Category is displayedCompany limited by Sharesstring
email_idEmail id of the company/LLP[email protected]string
class_of_companyPublic, Private or other Class of company/LLPPrivatestring
number_of_members(applicable_in_case_of_company_without_share_capital)Number of Members of the company/LLP0string
address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintainedOther Address of the Company/LLP-string
date_of_last_agmDate of Last Annual30/09/2019string
registered_addressRegistered Address of Company/LLP123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 80015 INstring
registration_numberRegistration number of Company/LLP999999string
paid_up_capital(rs)Paid up capital of company100000string
whether_listed_or_notWhether company is listed or not in Stock ExchangeUnlistedstring
suspended_at_stock_exchangeWhether company is suspended at a stock exchange or not-string
cinCIN of the CompanyU12300GJ2017PTC123456string
company_subcategorySubcategory of companyNon-govt companystring
authorised_capital(rs)Authorised capital of company100000string
company_status(for_efiling)Efiling status of the CompanyActivestring
roc_codeROC Code of ROC where Company is registeredRoC-Ahmedabadstring
date_of_balance_sheetBalance Sheet Date31/03/2019string
date_of_incorporationDate of incorporation of the Company09/06/2017string
company_nameName of the companyJOHN DOE PRIVATE LIMITEDstring