MCA Company Documents API

The MCA Company Documents API orders the documents a company or LLP has filed, by its CIN or LLPIN (or FCRN or FLLPIN for a foreign company or LLP). When the order completes, it lists each document with its title, category, form number and date, for example the Certificate of Incorporation, MGT-7 annual returns, AOC-4 financial statements and other eForms, with a download path for each file and for a ZIP of all of them. The company’s details come back with the order in the same fields as the CIN Verification API.

Filed documents are where the detail sits: the financial statements behind a credit decision, the shareholding in an annual return, the charges a lender has registered, the resolutions that changed a company’s directors or objects.

This is an asynchronous API. The order is accepted at once with an id and status pending; you read it back with GET /mca-docs-download/list/{id} until it is completed or failed, then download the files. Only one order per company is accepted every 24 hours, and downloaded files may be removed after a retention period that the storage-policy endpoint tells you.

How it works

1. 1

   Your server sends POST /mca-docs-download/create with the cin (a CIN, LLPIN, FCRN or FLLPIN), optionally the company_name and a client_ref. The answer carries the order id with status pending.

2. 2

   If an order for the same company was placed in the last 24 hours, the request is refused with 409 (order_recent) before anything is charged; the answer gives retryAfter and, when the earlier order was yours, its existingId.

3. 3

   The documents finish later. Poll GET /mca-docs-download/list/{id} until status is completed (or failed, which is refunded unless the identifier was invalid).

4. 4

   Download each file with GET /mca-docs-download/file/{filePath}, using the document’s download_path or the archive_download_path for a ZIP. Downloads are free; check GET /mca-docs-download/storage-policy for how long files are kept.