How to Use Finanvo’s V3 Document Download API: Complete 2025 Developer Guide (With Step-by-Step Tutorial)
Introduction
In India, corporate compliance data—ROC filings, financial statements, annual returns, and company master information—forms the backbone of due diligence, lending decisions, onboarding, vendor assessments, and credit monitoring. Traditionally, acquiring these filings manually from the MCA portal has been slow, inconsistent, and operationally heavy.
Finanvo solves this problem through a fully-automated Documents V3 API, allowing businesses, fintech companies, NBFCs, CRMs, and risk-tech platforms to purchase credits, place document orders, fetch individual filings, or download the complete ZIP package via REST-based endpoints.
This article is your complete technical tutorial, support manual, and use-case guide on:
What the V3 Document API does
When and why it should be used
How credits work
Step-by-step API workflow with sample flows
Understanding the status codes
Best practices for developers
Troubleshooting and support information
Whether you are a developer integrating this API into your product, a credit analyst automating report downloads, or a founder building a compliance automation workflow—this guide covers everything you need to get started seamlessly.
What Is the V3 Document Download API?
The Documents V3 API is a premium Finanvo service that lets you:
Fetch ROC filings for a company (CIN)
Download MCA financials, AOC-4, MGT-7, charge documents, incorporation filings, etc.
Retrieve documents individually or as a ZIP file
Track the order status and processing progress
Automate the entire MCA-document download lifecycle
The API supports high-volume automated workflows, making it ideal for:
Risk Intelligence Platforms
Loan Underwriting Systems
Compliance Engines
Enterprise CRMs
Due-Diligence Tools
NBFC/KYC Teams
Data Aggregation Platforms
If your business needs MCA documents reliably and quickly, the V3 API is designed for you.
Prerequisites
Before using the API, you must have:
Finanvo API Key & Secret
Sufficient V3 Document Credits
A valid CIN (Corporate Identification Number)
Access to API docs:
Step-by-Step Guide to Downloading V3 Documents
Step 1: Buy V3 Document Credits
The Documents V3 API is a credit-based service.
To buy credits:
👉 https://finanvo.in/app/subscription/buy/DOWN_DOCS_V3
Once purchased:
Your wallet is instantly updated
Credits are consumed per document retrieval order
These credits authorize your account to initiate Step 1 – Create Order.
Step 2: Create an Order for V3 Documents (For a CIN)
This step starts the workflow.
You call the API endpoint to place an order for retrieving the documents of a specific company.
Purpose of This Step
Deducts necessary credits
Logs an order against your account
Initiates the background process of collecting MCA filings
Prepares the system for subsequent download steps
Once the order is successful, you have two choices:
Option A — Download individual documents → Step 3
Option B — Download complete ZIP package → Step 5
Step 3: Retrieve List of Documents (Individual Files)
After the order is placed, you can call:
Get V3 Documents List API
This API returns:
A structured document list
File names
Document types
Direct download links
Availability status
Unique file URLs for Step 4
Use this response to download each document individually.
This step is useful when:
You need only selected documents
You want to store files individually in your internal folders
You need to map specific filing types (e.g., AOC-4 only)
Step 4: Download Each Document via Its Individual Link
This is the core download process.
To download a document:
Extract the document link from Step 3
Make a GET request
Pass your API key & Secret
Save the file locally or in cloud storage (S3, GCS, Azure Blob, etc.)
This ensures maximum granularity and control for your document workflows.
Step 5 (Option B): Download ZIP File – All Documents Together
Developers who prefer automation choose this method.
You have two APIs:
Get All Transactions
→ Fetches all your orders + ZIP links
Get Transactions by CIN
→ Fetches only the orders for a specific CIN
In the response you will receive:
ZIP Download Link
Processing Status
Timestamp
Document count
Order metadata
The ZIP file may take some time depending on:
Number of filings
Historical document size
MCA server speed
Load on zip-processing queue
Best practice:
Pull every 5–10 minutes until status = 2 (Completed).
Understanding Status Codes (Important for Developers)
The API returns numerical status indicators that show the stage of processing.
| Key | Value | Meaning |
|---|---|---|
| Status | 0 | Not Paid |
| Status | 1 | Paid |
| Processing_status | 0 | Not Started |
| Processing_status | 1 | Download in Progress |
| Processing_status | 3 | ZIP In Progress |
| Processing_status | 4 | No Documents Available |
| Processing_status | 2 | Completed |
Explanation of Lifecycle
1️⃣ Status = 1 (Paid)
Your order is successfully placed.
2️⃣ Processing_status = 0 → 1
Documents are being fetched from MCA.
3️⃣ Processing_status = 3
System is bundling files into a ZIP.
4️⃣ Processing_status = 2
Your ZIP file is ready.
5️⃣ Processing_status = 4
Means:
No filings available
Company may be newly incorporated
MCA has no public documents
Why Use Finanvo’s V3 Document API? — Use Cases
1. Automated Due-Diligence
Credit analysts spend hours downloading MCA documents manually.
The API enables fully automated workflows:
Fetch CIN data
Retrieve financials
Plug into risk engines
2. Loan Underwriting Automation
NBFCs and lenders require:
Balance sheets
Profit & Loss statements
Annual returns
Charge information
This API helps their underwriting system auto-fetch documents before loan approval.
3. KYC / Corporate Onboarding
For onboarding vendors or corporate customers:
Validate company compliance
Verify directors
Download incorporation filings
4. Enterprise CRMs & Workflows
Platforms like:
Zoho CRM
Salesforce
Custom internal CRMs
can integrate V3 API for instant MCA data retrieval.
5. Audit & Compliance Tech
Companies offering:
GST–MCA reconciliation
Financial audits
Compliance monitoring
use this to streamline report generation.
6. B2B SaaS and Fintech Platforms
Data aggregation and SME-fintech companies embed the API into dashboards for:
Real-time data
Document history
Compliance scoring
Sample Integration Flow (Developer-Friendly)
Below is the recommended workflow:
Best Practices for API Integration
1. Always use async or background jobs
Document generation may take time, so avoid blocking your UI.
2. Implement retry logic
Network delays from MCA are normal during peak hours.
3. Store documents securely
Use:
AWS S3
Google Cloud Storage
Encrypted local servers
4. Log transaction IDs
Makes support faster.
5. Avoid hitting ZIP download API repeatedly
Use polling intervals of 10–20 seconds.
6. Cache results when possible
Especially for frequently downloaded CINs.
Troubleshooting Guide
Issue: “Processing_status stays at 1 or 3”
Reason: Large filings / MCA slow
Solution: Continue polling; ensure your system is not blocking async jobs.
Issue: ZIP shows “No Documents Available”
Possible reasons:
CIN has no public filings
Newly incorporated company
Issue: “Not Paid” status
→ Credits not available
→ Ensure subscription is active
Issue: “Invalid Key/Secret”
→ Regenerate key from your Finanvo account
→ Ensure headers are correct
Issue: Download links expire
→ Always re-fetch via Step 3 if using stale URLs
Support & Help Manual
If you face any issues:
1. API Documentation
https://documenter.getpostman.com/view/14652297/TzXukeTe#cac2960d-edfe-1e05-fc24-1434f09c9f69
2. Purchase Credits
https://finanvo.in/app/subscription/buy/DOWN_DOCS_V3
3. Contact Support
You can reach Finanvo via:
Email:support@finanvo.in
WhatsApp Support: Available in dashboard
In-App Tickets: Recommended for technical issues
Provide:
Order ID
CIN
Timestamp
API response
Gateway logs (if available)
4. Typical Response Times
Technical support: within 2–4 working hours
Complex issues (e.g., document mismatch): 6–12 hours
Conclusion
Finanvo’s V3 Document Download API is purpose-built for businesses that need speed, accuracy, automation, and reliability in retrieving MCA filings. From automated underwriting to enterprise compliance workflows, the API allows you to seamlessly fetch documents—either individually or as a ZIP—powered by a structured credit system and real-time status tracking.
By following the step-by-step tutorial:
1️⃣ Buy Credits
2️⃣ Create Order
3️⃣ Fetch Document List
4️⃣ Download Files
5️⃣ Download ZIP (optional)
you can integrate this endpoint into any system within minutes.
The API is robust, developer-friendly, and operationally reliable — making it one of the fastest and most accurate ways to access MCA filings at scale.
Leave a comment
Your email address will not be published. Required fields are marked *