Company Consolidated

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
Production environment
POST https://signzy.tech/api/v2/patrons/<patron-id>/companyconsolidated
POST https://signzy.tech/api/v2/patrons/<patron-id>/companyconsolidated
﻿
UAT/Testing environment
POST https://preproduction.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
JSON
{
    "task": "fetch",
    "essentials": {
        "cin": "<CIN of the company>",
        "pan": "XXXXX0000X", 
        "callbackUrl": "https://preproduction.signzy.tech"
    }
  }
{
    "task": "fetch",
    "essentials": {
        "cin": "<CIN of the company>",
        "pan": "XXXXX0000X", 
        "callbackUrl": "https://preproduction.signzy.tech"
    }
  }
﻿
﻿
Code samples
Curl
Node.js
Python
Go
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"
    }
  }'
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.
JSON
{
    "essentials": {
        "cin": "<CIN of the Company>",
        "pan": "XXXXX0000X",
        "callbackUrl": "https://preproduction.signzy.tech"
    },
    "id": "6575cf7718b8c40023feb7e8",
    "patronId": "<Your Patron ID>",
    "task": "fetch",
    "result": {
        "requestId": "6575cf77e6aedb001194abab"
    }
}
{
    "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!

Fetch by CIN realtime

Get by request ID

Docs powered by Archbee

TABLE OF CONTENTS

Request body parameters

Code samples

Response body parameters

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.

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