Fetch by CIN

Introduction

The Fetch by CIN API is designed to streamline access to detailed information about a company. By inputting a Corporate Identification Number (CIN) or PAN number of the company, you are provided with a unique request ID. This request ID can then be used in Get by request ID API to fetch comprehensive details about the specified company

API details

Endpoint

POST https://signzy.tech/api/v2/patrons/<patron-id>/companyconsolidated

POST https://preproduction.signzy.tech/api/v2/patrons/<patron-id>/companyconsolidated

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
task	String	Specifies the type of task to be performed. It should be “fetch" for this task.	Mandatory
essentials	Object	Contains the essential parameters for the task.	Mandatory
essentials.cin	String	Corporate Identification Number. If both CIN and PAN are provided in the request, fetch will be performed using the CIN number.	Conditionally Mandatory
essentials.pan	String	PAN number of the Company.	Conditionally Mandatory
essentials.callbackUrl	String	The callback URL to which the response should be sent.	Mandatory

{
    "task": "fetch",
    "essentials": {
        "cin": "<CIN of the company>",
        "pan": "XXXXX0000X", 
        "callbackUrl": "https://preproduction.signzy.tech"
    }
  }

Code samples

curl --location 'https://preproduction.signzy.tech/api/v2/patrons/<Your Patron ID>/companyconsolidated' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Your access token>' \
--data '{
    "task": "fetch",
    "essentials": {
        "cin": "<CIN of the company>",
        "pan": "XXXXX0000X",
        "callbackUrl": "https://preproduction.signzy.tech"
    }
  }'

Response body parameters

Parameter	Data Type	Description
essentials	Object	Contains essential parameters for the request.
essentials.cin	String	Corporate Identification Number.
essentials.pan	String	PAN number of the company.
essentials.callbackUrl	String	The callback URL to which the response should be sent.
id	String	Unique ID for the request.
patronId	String	Your patron ID is returned here.
task	String	The specific task to be performed.
result	Object	Contains the results of the request.
result.requestId	String	Request ID generated for the CIN that can be used in Get by Request ID API to fetch company details.

{
    "essentials": {
        "cin": "<CIN of the Company>",
        "pan": "XXXXX0000X",
        "callbackUrl": "https://preproduction.signzy.tech"
    },
    "id": "6575cf7718b8c40023feb7e8",
    "patronId": "<Your Patron ID>",
    "task": "fetch",
    "result": {
        "requestId": "6575cf77e6aedb001194abab"
    }
}

Typically, fetching data from the MCA takes 4-6 hours within its working hours (9 AM to 5:30 PM). This time might be affected as per MCA website availability. However, if data is requested outside these hours, or shortly before closing, it will be available on the following working day.

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!