Skip to main content
POST
/
mca
/
company
/
master-data
/
search
Company Master Data
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": "U12345AB1234ABC123456",
  "consent": "y",
  "reason": "for KYC"
}'
{
  "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"
      }
    ]
  }
}

Headers

ā€‹
authorization
string
required

JWT access token

ā€‹
x-api-key
string
required

API key for identification

ā€‹
x-api-version
string

API version

Body

application/json
ā€‹
@entity
string
default:in.co.sandbox.kyc.mca.master_data.request
required

entity name

ā€‹
id
string
required

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
string
required

Consent of the end-user to get their information for verification purposes. Possible values: Y and y

ā€‹
reason
string
required

Purpose for which the user has given their consent.

Response

200 - OK

  • CIN
  • LLPIN
ā€‹
code
integer
default:0
Example:

200

ā€‹
timestamp
integer
default:0
Example:

1614696176218

ā€‹
transaction_id
string
Example:

"611335dc-8be4-40d1-8438-b86526462939"

ā€‹
data
object