Company Master Data

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

API Pricing Image

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 Endpoint  Contact Us  Free Trial

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

ParamTypeDescriptionExample
company_categorystringCompany/LLP Category is displayed.
Possible values are:
Company limited by Shares,
Company limited by guarantee,
Unlimited company
Company limited by Shares
email_idstringEmail id of the company/LLP[email protected]
class_of_companystringPublic, Private or other Class of company/LLP
Possible values are:
Private,
Public,
One person Company
Private
number_of_members(applicable_in_case_of_company_without_share_capital)stringNumber of Members of the company/LLP0
address_other_than_r/o_where_all_or_any_books_of_account_and_papers_are_maintainedstringOther Address of the Company/LLP-
date_of_last_agmstringDate of Last Annual30/09/2019
registered_addressstringRegistered Address of Company/LLP123, ABC LAKEVIEW TOWER OPPOSITE A COMPLEX, AHMEDABAD Ahmedabad GJ 80015 IN
registration_numberstringRegistration number of Company/LLP999999
paid_up_capital(rs)stringPaid up capital of company100000
whether_listed_or_notstringWhether company is listed or not in Stock Exchange
Possible values are:
Listed,
Unlisted
Unlisted
suspended_at_stock_exchangestringWhether company is suspended at a stock exchange or not-
cinstringCIN of the CompanyU12300GJ2017PTC123456
company_subcategorystringSubcategory of company
Possible values are:
Union government company,
State government company, Non-government company, Subsidiary of company incorporated outside India, Guarantee and association company
Non-govt company
authorised_capital(rs)stringAuthorised capital of company100000
company_status(for_efiling)stringEfiling status of the Company
Possible values are:
Active, Dormant, Dormant Under Section 455, Active In Progress, Amalgamated, Not Available for eFiling, Converted to LLP, Converted to LLP and Dissolved, Dissolved, Under Liquidation, Liquidated, Under Process of Striking Off, Strike Off, Captured
Active
roc_codestringROC Code of ROC where Company is registeredRoC-Ahmedabad
date_of_balance_sheetstringBalance Sheet Date31/03/2019
date_of_incorporationstringDate of incorporation of the Company09/06/2017
company_namestringName of the companyJOHN DOE PRIVATE LIMITED

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Company Master Data API is not a Paid API, no wallet charge will take place.

Versioning

This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.

VersionDescriptionEndpoint
1.0This is the first version of the APIAPI Endpoint

Refer to our versioning policies here