> For the complete documentation index, see [llms.txt](https://help.jurisphere.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.jurisphere.ai/resources/errors-and-faqs/mca-documents-job-failed.md).

# MCA Documents: Job Failed

{% hint style="info" %}
⚠️ **Important**\
Jurisphere is currently integrated only with **MCA V3**. MCA had initially announced July as the deadline for migrating all filings from V2 to V3, but the migration is still in progress. Access to **V2 APIs has already been revoked**, which means:

* V2 previously hosted **financial documents**.
* V3 hosts **all other filings**.
* Some newer companies may already have financials available in V3.
* If financials are missing, they can only be downloaded manually from the MCA website.
  {% endhint %}

Sometimes when you start an **MCA Documents** task, you may see a failure notification (a red ❗ icon or error message) indicating that the **MCA job failed** for a company search or document download.

> <img src="/files/gT856tm32NQ7bdJ9ulGM" alt="" data-size="original">

***

### Possible Causes

1. **Invalid or incorrect CIN / company details**\
   If the CIN or company name is entered incorrectly, the system cannot fetch the records from MCA.
2. **MCA portal restrictions**\
   The MCA system may temporarily block or throttle requests if there are too many queries in a short time, leading to job failure.
3. **Unavailable filings or missing documents**\
   If the company has not filed certain documents (e.g., annual returns, charge documents), the request may return empty or error out.
4. **V2 vs V3 migration issue**\
   MCA is in the process of migrating filings from V2 to V3. Since Jurisphere connects only to V3:
   * Financials not yet migrated will not be retrievable.
   * These will need to be manually downloaded from MCA’s website.
5. **Corrupted or incomplete document on MCA portal**\
   Occasionally, documents hosted on MCA may themselves be corrupted or incomplete, which prevents proper retrieval.
6. **Backend / server hiccups**\
   Temporary system issues on either the MCA side or Jurisphere’s processing queue can cause the job to fail.

***

### Troubleshooting Steps

1. **Verify company details**
   * Double-check the **CIN** or **company name** entered.
   * Ensure it matches the MCA master data exactly.
2. **Check if the filing is available in V3**
   * Remember that Jurisphere can only fetch filings available in MCA **V3**.
   * Financials missing on V3 must be downloaded manually from the MCA portal.
3. **Retry after a short interval**
   * If MCA’s portal is down or throttling requests, wait a few minutes and try again.
4. **Check document availability**
   * Some filings may not be available for download if they were never uploaded by the company.
   * Try with another filing to confirm whether the issue is file-specific.
5. **Contact support**
   * If the error persists across multiple companies or filings, reach out via the in-app support channel or on your customer support group. For priority support, our team will assist you in procuring the required documents directly over email.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.jurisphere.ai/resources/errors-and-faqs/mca-documents-job-failed.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.