Get MCA files - Retrieve Request

Introduction

Following the Get MCA Files - Intiate request API, the "Get MCA Files - Retrieve request" API is the crucial second phase in the process of downloading company documents from the Ministry of Corporate Affairs (MCA). Once you have received a request ID from the first API, this API facilitates the actual retrieval of the documents. It specializes in securely and efficiently delivering the previously requested Articles of Association (AOA), Memorandum of Association (MOA), and Certificate of Incorporation (COI) in a user-friendly PDF format.

API Details

Endpoint

curl --location 'https://api.signzy.app/api/v3/global/mca-files/retrieve' \
--header 'Authorization:****' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "<requestId>"
}'

curl --location 'https://api-preproduction.signzy.app/api/v3/global/mca-files/retrieve' \
--header 'Authorization:****' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "<requestId>"
}'

Request body parameters

Parameter	Data Type	Description	Required
requestId	String	The request ID generated in step 1	Mandatory

Response body

{
    "result": {
        "companyDocuments": {
            "cin": "U47219CT2023PTC014922",
            "callbackUrl": "<callbackUrl>",
            "requestId": "<requestId>",
            "files": [
                {
                    "documentType": "MOA",
                    "documentUrl": "<documentUrl>",
                    "documentName": "MOA_U47219CT2023PTC014922.pdf",
                    "documentFilingDate": "<documentFilingDate>""
                },
                {
                    "documentType": "AOA",
                    "documentUrl": "<documentUrl>",
                    "documentName": "AOA_U47219CT2023PTC014922.pdf",
                    "documentFilingDate": "<documentFilingDate>""
                },
                {
                    "documentType": "COI",
                    "documentUrl": "<documentUrl>",
                    "documentName": "COI_U47219CT2023PTC014922.pdf",
                    "documentFilingDate": "<documentFilingDate>"
                }
            ],
            "status": "FULFILLED",
            "lastUpdate": "20/05/2026",
            "isComplete": 1
        }
    },
    "reason": "Request Successful",
    "code": "S001"
}

Response body parameters

Parameter	Data Type	Description
result	Object	The main container object for the successful payload.
result.companyDocuments	Object	Contains the detailed metadata and files for the requested company.
result.companyDocuments.cin	String	The Corporate Identification Number (CIN) of the company.
result.companyDocuments.callbackUrl	String	The URL provided for asynchronous callback notifications.
result.companyDocuments.requestId	String	Unique identifier for the specific API request.
result.companyDocuments.files	Array	A list of document objects associated with the company.
result.companyDocuments.files[i].documentType	String	Type or category of the document (e.g., MOA, AOA, COI).
result.companyDocuments.files[i].documentUrl	String	URL to download or view the specific document.
result.companyDocuments.files[i].documentName	String	Name or title of the document file.
result.companyDocuments.files[i].documentFilingDate	String	Filing date of the document.
result.companyDocuments.status	String	Status of the document retrieval request (e.g., FULFILLED).
result.companyDocuments.lastUpdate	String	The date when the document details were last updated (formatted as DD/MM/YYYY).
result.companyDocuments.isComplete	Integer	Boolean flag represented as an integer (e.g., 1 for true, 0 for false) indicating if the document set is complete.
reason	String	Human-readable message detailing the outcome of the request.
code	String	System response code indicating success or failure (e.g., S001).

Error codes

HTTP Status Code	Error Code	Description
400	E001	Bad Request
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

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!