Company Master Data
curl --request POST \
--url https://test-api.sandbox.co.in/kyc/mca/company/master-data \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"cin": "U47219GJ2023PTC143977"
}
'import requests
url = "https://test-api.sandbox.co.in/kyc/mca/company/master-data"
payload = { "cin": "U47219GJ2023PTC143977" }
headers = {
"Authorization": "<authorization>",
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'x-api-key': '<x-api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({cin: 'U47219GJ2023PTC143977'})
};
fetch('https://test-api.sandbox.co.in/kyc/mca/company/master-data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://test-api.sandbox.co.in/kyc/mca/company/master-data",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cin' => 'U47219GJ2023PTC143977'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://test-api.sandbox.co.in/kyc/mca/company/master-data"
payload := strings.NewReader("{\n \"cin\": \"U47219GJ2023PTC143977\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://test-api.sandbox.co.in/kyc/mca/company/master-data")
.header("Authorization", "<authorization>")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cin\": \"U47219GJ2023PTC143977\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://test-api.sandbox.co.in/kyc/mca/company/master-data")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cin\": \"U47219GJ2023PTC143977\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"timestamp": 1782021074236,
"data": [
{
"updated_at": 1783351002317,
"@entity": "in.co.sandbox.kyc.mca.company_master_data",
"cin": "U72900GJ2015PTC082637",
"company_name": "QUICKO INFOSOFT PRIVATE LIMITED",
"company_roc_code": "ROC Ahmedabad",
"company_category": "Company limited by shares",
"company_sub_category": "Non-government company",
"company_class": "Private",
"authorized_capital": 15200000,
"paidup_capital": 14566670,
"company_registration_date": "2015-03-19",
"registered_office_address": "B/701 ,Amrapali Lakeview Tower Opp.Vastrapur Lake, Vastrapur,Ahmedabad,Ahmedabad,Gujarat,380015-India",
"listing_status": "Unlisted",
"company_status": "Active",
"company_state_code": "gujarat",
"company_origin": "India",
"nic_code": "72900",
"company_industrial_classification": "Business Services"
}
],
"transaction_id": "321e98ad-b002-4c4e-ad6b-34121e06c127"
}{
"code": 400,
"timestamp": 1783331537495,
"message": "Invalid request body",
"transaction_id": "242c5503-7ae0-4b01-b5ac-6f14177c0096"
}{
"code": 521,
"timestamp": 1783331595884,
"message": "Company master data not found for CIN: U34300GJ2017PLC097818",
"transaction_id": "66e9235e-a9b2-4646-a39c-79fc3df114b0"
}Company Master Data
API takes in the Corporate Identification Number (CIN) or Limited Liability Partnership Identification Number (LLPIN) as cin to identify and retrieve basic information about the company.
POST
/
kyc
/
mca
/
company
/
master-data
Company Master Data
curl --request POST \
--url https://test-api.sandbox.co.in/kyc/mca/company/master-data \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"cin": "U47219GJ2023PTC143977"
}
'import requests
url = "https://test-api.sandbox.co.in/kyc/mca/company/master-data"
payload = { "cin": "U47219GJ2023PTC143977" }
headers = {
"Authorization": "<authorization>",
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'x-api-key': '<x-api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({cin: 'U47219GJ2023PTC143977'})
};
fetch('https://test-api.sandbox.co.in/kyc/mca/company/master-data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://test-api.sandbox.co.in/kyc/mca/company/master-data",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cin' => 'U47219GJ2023PTC143977'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://test-api.sandbox.co.in/kyc/mca/company/master-data"
payload := strings.NewReader("{\n \"cin\": \"U47219GJ2023PTC143977\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://test-api.sandbox.co.in/kyc/mca/company/master-data")
.header("Authorization", "<authorization>")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cin\": \"U47219GJ2023PTC143977\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://test-api.sandbox.co.in/kyc/mca/company/master-data")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cin\": \"U47219GJ2023PTC143977\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"timestamp": 1782021074236,
"data": [
{
"updated_at": 1783351002317,
"@entity": "in.co.sandbox.kyc.mca.company_master_data",
"cin": "U72900GJ2015PTC082637",
"company_name": "QUICKO INFOSOFT PRIVATE LIMITED",
"company_roc_code": "ROC Ahmedabad",
"company_category": "Company limited by shares",
"company_sub_category": "Non-government company",
"company_class": "Private",
"authorized_capital": 15200000,
"paidup_capital": 14566670,
"company_registration_date": "2015-03-19",
"registered_office_address": "B/701 ,Amrapali Lakeview Tower Opp.Vastrapur Lake, Vastrapur,Ahmedabad,Ahmedabad,Gujarat,380015-India",
"listing_status": "Unlisted",
"company_status": "Active",
"company_state_code": "gujarat",
"company_origin": "India",
"nic_code": "72900",
"company_industrial_classification": "Business Services"
}
],
"transaction_id": "321e98ad-b002-4c4e-ad6b-34121e06c127"
}{
"code": 400,
"timestamp": 1783331537495,
"message": "Invalid request body",
"transaction_id": "242c5503-7ae0-4b01-b5ac-6f14177c0096"
}{
"code": 521,
"timestamp": 1783331595884,
"message": "Company master data not found for CIN: U34300GJ2017PLC097818",
"transaction_id": "66e9235e-a9b2-4646-a39c-79fc3df114b0"
}Run in Postman
Headers
JWT access token. For token-generation steps, refer to the Quickstart Guide.
API key used to identify and authenticate the client.
Specifies the API version for the request.
Media type of the request body.
Available options:
application/json Optional cache-control header. For cache behavior details, refer to Response Caching.
Optional source selector. Allowed values are primary and secondary. For request-behavior details, refer to the MCA Overview.
Available options:
primary, secondary Body
application/json
Corporate Identification Number of the company
Required string length:
21Pattern:
^[LU]\d{5}[A-Z]{2}\d{4}[A-Z]{3}\d{6}$Was this page helpful?
āI