Company data API
Company Documents API
List a company's filed MCA documents with form type, filing date and financial year.
GET /v1/companies/{cin}/documents
3 credits per successful call · full rate card
Overview
The Company Documents API returns the catalogue of an Indian company's filed MCA documents with metadata - form type, document name, filing date, financial year and file size. Use it to locate the exact filing you need. Paginated with optional year filtering.
- Filed MCA document metadata
- Form type, name, filing date, financial year
- Total count and pagination
- Optional year filter
- Clean, paginated JSON
Auth, limits & freshness
- Auth: Send Authorization: Bearer <api_key> (pk_test_… or pk_live_…).
- Rate / credits: Fair-use and plan limits apply; see your API console for remaining credits.
- Freshness: Sourced from Infyner’s MCA-aligned company master; refresh cadence varies by dataset.
- Errors: Errors return a JSON envelope with success=false and an error code (e.g. NOT_FOUND, UNAUTHORIZED).
How it works
- Generate an API key in your developer console (test keys are free).
- Call the endpoint with your Bearer key.
- Read the JSON response (standard envelope with credits info).
- Map the fields into your product or workflow.
Request & response
Requestcurl "https://www.infyner.com/v1/companies/L74999WB1991PLC051738/documents?page=1" \
-H "Authorization: Bearer pk_test_xxxxxxxx"
Response (sample){
"success": true,
"data": {
"cin": "...", "total_documents": 42, "page": 1,
"documents": [ { "form_type": "AOC-4", "file_name": "Financial Statements 2024", "filing_date": "2024-10-12", "financial_year": "2024" } ]
}
}
Try it live with a free test key from your sandbox.
Where it's used
- Find a specific MCA filing
- Build a company documents index
- Track new filings over time
- Diligence document gathering
Frequently asked questions
Can I download documents through this API?
This endpoint returns document metadata (form, date, year). The document download itself is handled separately.
Related APIs
Company Search API
Search Indian companies by name or CIN and get the top matching companies with their CIN.
Company CIN Lookup API
Get a company's core details from its CIN in real time - name, status, incorporation, registered office and ROC.
CIN to PAN
Get a company's PAN from its CIN using Infyner's company master — charged only when PAN is available.
Start building in minutes
Generate a free test key, call the sandbox, and go live when you're ready.
Get API access