MCA Docs Download API Category
Overview#
The MCA Docs Download API category provides a comprehensive solution for retrieving official documents from the Ministry of Corporate Affairs (MCA) for registered companies and LLPs in India. This API suite enables developers to programmatically request, track, and download various corporate documents filed with the MCA, streamlining the due diligence and compliance verification processes.Parent Category: Root
Child Categories: None
APIs in this category: Create Order, Get Status, Order List
Key Capabilities#
Main Functionality
This API category allows you to retrieve official MCA documents for companies and LLPs, track document retrieval status, and implement flexible document fetching strategies to optimize your workflow.
Document Retrieval
Request and download official documents filed with the Ministry of Corporate Affairs for any registered company or LLP using their CIN or LLPIN.
Lazy Document Fetching
Pre-fetch document lists and selectively download only the specific documents you need, optimizing bandwidth and processing resources.
Status Tracking & Notifications
Monitor document retrieval progress in real-time and receive webhook notifications when documents are fetched or orders are completed.
Common Use Cases#
Due diligence for loan approvals and credit assessments
Verification of company financials and statutory filings
KYC compliance for corporate clients
Integration Considerations#
Best Practices
Use the "fetch_only" mode for large document sets to review available documents before downloading
Implement webhook handlers to receive real-time updates on document retrieval status
Store document URLs securely as they contain sensitive corporate information
Consider rate limits and processing times when making multiple requests
In sandbox environment, only specific test entity IDs will work (see API documentation)
Webhook secret must be configured before using webhook functionality
Document availability depends on what has been filed with the MCA
Some documents may require payment to the MCA for retrieval
How APIs in this Category Work Together#
The MCA Docs Download APIs work together to create a complete document retrieval workflow, from initial order creation to final document delivery. Each API handles a specific part of the document retrieval lifecycle.Key Integration Patterns:Create Order + Get Status: Initiate document retrieval and then poll for status updates until completion
Create Order (fetch_only) + Register Fetched Order: First fetch the list of available documents, then selectively download only the documents you need
Create Order + Webhook Integration: Initiate document retrieval and receive automatic notifications when documents are ready
Company Verification: Verify basic company information before requesting detailed MCA documents
Director Verification: Cross-reference director information found in MCA documents with other verification sources
Document Analysis: Process downloaded MCA documents to extract structured data for further analysis
Data Models#
MCA Response Object#
| Key | Format | Description |
|---|
| client_id | String | Unique Client ID |
| entity_type | String | "company" or "llp" |
| entity_name | String | Name of the company |
| status | String | "pending", "failed", "paused", "partially_completed", or "completed" |
| mca_payment | Boolean | Whether payment was made for this particular order |
| mca_srn | String | MCA SRN number |
| fetch_only | Boolean | Fetch only mode or not |
| fetched | Boolean | Documents list fetched or not. Applicable only in "fetch only" mode |
| documents | Array of Objects | List of document objects (see Documents Object) |
Documents Object#
| Key | Format | Description |
|---|
| document_id | String | Unique ID for this document |
| document_name | String | Name of the document |
| category | String | Category of the document |
| status | String | "pending", "completed", or "failed" |
| document_url | String | URL to download the document |
Lazy Fetching of Documents#
If you want to pre-fetch the list of MCA documents and selectively download only specific documents, you can use the "fetch only" mode by setting the fetch_only parameter to true in your Create Order request.In this mode, the system will:1.
Create an order in the paused state
2.
Fetch the list of available documents from MCA
3.
Allow you to select which documents to download using the Register Fetched Order API
MCA Webhook Integration#
For real-time notifications about document retrieval status, you can configure a webhook URL when creating an order. The system will send webhook events in the following scenarios:MCA_FETCH_DOCS: Sent when the list of available documents has been fetched in "fetch only" mode
MCA_ORDER: Sent when the order is completed and documents have been downloaded
Webhook Object Structure#
| Key | Format | Description |
|---|
| event | String Enum | Type of event. One of MCA_ORDER or MCA_FETCH_DOCS |
| data | Object | Complete MCA Response Object |
Ensure you have configured your webhook secret before using the webhook functionality to validate incoming webhook requests.
