Get all files by CIN (V3)
Introduction
Following the initial Fetch All Files by CIN API, the "Get All Files by CIN" API is the essential second step in our two-stage process for downloading comprehensive company documents from the Ministry of Corporate Affairs (MCA). After obtaining a request ID from the "Fetch All Files by CIN" API, this follow-up API enables the actual acquisition of the documents. Designed to provide a secure, efficient, and user-friendly method for retrieving a full range of corporate documents, it is an indispensable tool for professionals requiring detailed and complete corporate information for legal, financial, and compliance purposes. This API completes your data retrieval process, ensuring access to all necessary documents with minimal effort and maximum reliability.
API Details
Endpoint
POST https://api.signzy.app/api/v3/roc/getAllFilesByCinPOST https://api-preproduction.signzy.app/api/v3/roc/getAllFilesByCinRequest body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
requestId | String | Request ID got from "fetch all files by cin" API | Mandatory |
Request body
{
"requestId": "<Request ID>"
}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. |
Code samples
curl --location 'https://api-preproduction.signzy.app/api/v3/roc/getAllFilesByCin' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth token>' \
--data '{
"requestId": "<Request ID>"
}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result.companyDocuments.cin | String | CIN (Corporate Identification Number) of the company |
result.companyDocuments.callbackUrl | String | Callback URL (if available) |
result.companyDocuments.requestId | String | Request ID for the document retrieval |
result.companyDocuments.files[i].documentType | String | Type or category of the document |
result.companyDocuments.files[i].documentUrl | String | URL to download/view the document |
result.companyDocuments.files[i].documentName | String | Name or title of the document |
result.companyDocuments.files[i].documentFilingDate | String | The filing date of the document |
result.companyDocuments.files[i].documentStatus | String | Status of the document (e.g., completed) |
result.companyDocuments.status | String | Status of the document retrieval request |
result.companyDocuments.updatedTimestamp | Integer | Timestamp of when the document details were last updated |
result.companyDocuments.isComplete | Integer | Flag indicating if the document retrieval is complete |
Response body
{
"result": {
"companyDocuments": {
"cin": "<CIN number>",
"callbackUrl": "",
"requestId": "<Request ID>",
"files": [],
"status": "REQUESTED",
"updatedTimestamp": 1704805392,
"isComplete": 0
}
}
}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!