InstaBasic
Overview

InstaBasic APIs offers information about the following major sections:

  • Company Master data
  • Current Directors and Past Directors
  • Charges Information

Company Master Data offers insights about the demographical and geographical information which is key for any sign up form to enable prefill feature for any registration process. InstaBasic has wide range of business applications. Please talk to us to get the case study document which will offer in depth insights of possible automation or simplification that can be achieved using InstaBasic.

Documentation

[GET] InstaBasic

Returns InstaBasic data of a company for the given CIN.

  • URI Structure

    /InstaBasic/{APIVersion}/{ResponseType}/CompanyCIN/{CIN}/{DataCode}

    Example: /InstaBasic/V1/json/CompanyCIN/U72501KA2016PTC092387/all

  • Method:

    GET

  • URI Params

    1. {APIVersion} : Version of API (v1)
    2. {ResponseType} : Response Type (JSON/XML)
    3. {CIN} : Proper CIN of a company (this can be obtained from companySearch API)
    4. {DataCode} : Whether to return full data or customized data(ALL/CUSTOM)
  • Data Params

    None

  • Headers

    user-key:{userIdentificationKey}

  • Success Response:

    • Code: 200
    • Data:{Response}
  • Error Response:

    Data Key Data Type Data Description
    Status String Error
    Type String Self Descriptive expression.

    Self Descriptive expression:

    Type Error Action
    Unknown Error Undefined Error Contact to admin
    Invalid Prams Unrecognized Parameter Change Parameter
    Invalid Response Type Unrecognized Response Type Change Response Type
    Invalid Cin CIN not found Verify CIN
    Invalid Search Mode Unrecognized Search mode Change your Search mode
    Processing Error Undefined Error Contact to admin
    Load Error Error in loading data Retry
    Invalid uri Unrecognized URI Change URI
    Unauthenticated Unrecognized user-key or header Add valid user-key or header
  • Response output:

    Data Key Data Type Data Description
    LastUpdatedDateTime DateTime Last Date on which, all company master data relates to.
    CompanyCin String CIN of company, as per MCA
    CompanyPan String Permanent Account Number of Company
    CompanyName String Complete Legal Name of Company
    CompanyDateOfInc Date[DD-MM-YYYY] Date of which, company was incorporated
    CompanyRocCity String Regional City of MCA, relative to registered city of company.
    CompanyRegNumber String Registration number of company, within the state
    CompanyCategory String Category of Company, as per MCA, like, limited by shares, limited by guarantee etc.
    CompanySubCategory String Sub-category of Company, as per MCA, non-govt Company, foreign company etc
    CompanyClass String Class of Company, Public or Private.
    CompanyAuthCapital Monetary [INR Actuals] Total Authorized capital of company as on date.
    CompanyPaidUpCapital Monetary [INR Actuals] Total paid up capital of company as on date.
    CompanyRegFullAddress String Registered address of company, as per MCA Records
    CompanyRegState String State in which, registered address of company is located, as per MCA
    CompanyRegCity String City in which, registered address of company is located, as per MCA
    CompanyRegPinCode String Pin Code in which, registered address of company is located, as per MCA
    CompanyBookAddress String Book address of company, as per MCA Records, where books of accounts are maintained
    CompanyMcaStatus String Current e-Filing Status of Company, to MCA
    CompanyLastAgmDate Date[DD-MM-YYYY] Latest year end date, for which company has filed Balancend date, for which company has filed Balance
    CompanyLastBsDate Date[DD-MM-YYYY] Latest AGM date, as per MCA records
    CompanyEmail String Registered email id of Company
    CompanyWebSite String Website of company, where ever available.
    CompanyMcaIndustry String Major Industry Section, as per NIC 2004
    CompanyMcaIndustryDivision String Division of Industry classification, as per NIC 2004
    CompanyMcaIndustryGroup String Group of Industry classification, as per NIC 2004
    InstaFinancialsLink String URL of InstaFinancials to get more information about company
  • Sample Call:

    $.ajax({
        url: "/InstaBasic/V1/json/CompanyCIN/U72501KA2016PTC092387/all",
        headers: { 'user-key': 'xxxxxxxxxxxxxxxxxxxx' },
        dataType: "json",
        type : "GET",
        success : function(r) { console.log(r); }
    });
Resources

Coming soon!

API Demo (Sandboxed)
/InstaBasic/ / /CompanyCIN/ /
Generated URI : /InstaBasic/{{D1.Version}}/{{D1.ResponseType}}/CompanyCIN/{{D1.CIN.value}}/{{D1.DataCode}}
Generated CALL :
$.ajax({
    url: "/InstaBasic/{{D1.Version}}/{{D1.ResponseType}}/CompanyCIN/{{D1.CIN.value}}/{{D1.DataCode}}",
    headers: { 'user-key': 'xxxxxxxxxxxxxxxxxxxx' },
    dataType: "json",
    type : "GET",
    success : function(r) { console.log(r); }
});
Generated Response:
{{D1.SampleData}}
Downloads

Coming soon!