# Get your e-Filing portal notices and demands through an API

> Read the notices waiting in e-Proceedings, your submitted responses and your outstanding demands on the Income Tax e-Filing Portal with one API call each. A workflow can check e-Proceedings each morning and email you the new notices with their due dates.

Page: https://fous.com/automate/income-tax-e-filing-portal
Updated: 2026-11-12

Works with your own Income Tax e-Filing Portal account. Fous is an independent product.

## What you can build on the e-Filing portal

### Get notices waiting for your action

Reads the notices listed under Pending Actions, e-Proceedings, For your Action, with each proceeding's assessment year and response due date.

- Takes: Assessment year (optional)
- Returns: Proceeding name, section, assessment year, notice reference, issued on, response due date, status

### Get submitted responses

Reads the For your Information list in e-Proceedings: the responses already submitted, with the notice each one answers.

- Takes: Assessment year (optional)
- Returns: Proceeding name, assessment year, notice reference, response submitted on, number of attachments

### Check outstanding demands

Reads Pending Actions, Response to Outstanding Demand: each demand with its Demand Reference Number (DRN) and its status.

- Takes: Nothing
- Returns: DRN, assessment year, section, demand amount, interest, status

### Submit a response to a notice

Opens a notice under e-Proceedings, For your Action, enters your reply, attaches the documents and submits the response.

- Takes: Notice reference, reply text, attachments (up to 10)
- Returns: Notice reference, submitted on, acknowledgement reference, attachments uploaded

## Automate the e-Filing portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New notices in e-Proceedings, every morning

Starts: Every weekday at 8:00 India time

1. Get the notices waiting under e-Proceedings, For your Action.
2. Keep the notices that were not there on the last run.
3. Email you each new notice with its proceeding name, assessment year and response due date.

### Notice responses due within seven days

Starts: Every Monday at 9:00 India time

1. Get the notices waiting under e-Proceedings, For your Action.
2. Keep the notices whose response due date is in the next 7 days.
3. Post them, with notice reference and due date, to your task tracker's webhook.

### Outstanding demands, changes sent to accounting

Starts: Every Friday at 17:00 India time

1. Check the demands under Response to Outstanding Demand.
2. Keep the demands that are new or changed since the last run, and stop if there are none.
3. Post DRN, assessment year, amount, interest and status to your ERP's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get notices waiting for your action” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "eportal.incometax.gov.in/get_e_proceedings_notices",
    "input": {
      "assessment_year": "2025-26"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "taxpayer": "Acme India Private Limited",
    "notices": [
      {
        "proceeding_name": "Prima Facie Adjustment",
        "section": "143(1)(a)",
        "assessment_year": "2025-26",
        "notice_reference": "CPC/2526/A1/000000418",
        "issued_on": "2026-11-03",
        "response_due_date": "2026-12-03",
        "status": "Open"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The e-Filing portal’s own options

The Income Tax Department publishes APIs for e-Return Intermediaries (ERIs). They cover logging in, adding a taxpayer as a client with consent, fetching prefill data, validating and submitting an ITR, e-verifying it and getting the acknowledgement. Notices, demands and the other e-Filing screens are used in the portal itself.

| Option | What it covers | What it takes |
| --- | --- | --- |
| ERI APIs | Login, Add Client, Prefill, Validate and Submit ITR, e-Verify Return and Acknowledgement, for the ITR filing flow. | Being an e-Return Intermediary. Type-2 ERIs sign in with their own ERI user ID and password; taxpayer consent is needed to add a client. |
| Bulk upload of Form 15CB | A Chartered Accountant can upload Form 15CB in bulk. | A CA login on the portal, added as CA by the taxpayer and accepted, with a valid DSC for filing. |
| The e-Filing portal by hand | e-Proceedings (For your Action, For your Information), Response to Outstanding Demand and the other Pending Actions, one login at a time. | A login on the portal: user ID and password. |

Read on November 12, 2026: [API Specifications](https://www.incometax.gov.in/iec/foportal/api-specifications), [ERI API Specifications (v1.1)](https://www.incometax.gov.in/iec/foportal/sites/default/files/2021-11/ERI%20API%20Specification_v1.1.pdf), [Services available to Chartered Accountants](https://www.incometax.gov.in/iec/foportal/help/ca/servicesavailable).

## Signing in to the e-Filing portal

The e-Filing portal asks for your user ID and password, and shows your secure access message. If you turned on e-Filing vault higher security, the second factor is a bank account EVC, demat account EVC, DSC or Aadhaar OTP. With Fous you sign in through the portal's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Responses are final once submitted**: A response in e-Proceedings cannot be edited, updated or withdrawn after you submit it. Have someone read a reply before a method submits it.
- **10 attachments, 5 MB each, 50 MB in all**: A response takes at most 10 attachments, none larger than 5 MB, and 50 MB together. A method that submits a response has to stay within those limits.
- **When Submit Response closes**: Submit Response stays available until 6 PM, 7 days before the Proceeding Limitation Date. For CPC notices it turns inactive once the response due date has passed.
- **Five wrong passwords lock the account**: The portal locks a login after 5 unsuccessful attempts. It opens again by itself after 30 minutes, or sooner from the login page's own recovery option.

## More in Government: India and South Asia

- [MCA21](https://fous.com/automate/mca21.md)
- [GST Portal](https://fous.com/automate/gst-portal.md)
- [EPFO Unified Portal (Employer)](https://fous.com/automate/epfo-unified-portal-employer.md)
- [FBR IRIS](https://fous.com/automate/fbr-iris.md)
- [TRACES](https://fous.com/automate/traces.md)

Other industries: [My ARC](/automate/my-arc), [Facturación Electrónica DIAN](/automate/facturacion-electronica-dian), [CIPC eServices](/automate/cipc-eservices), [EUDR Information System](/automate/eudr-information-system), [Companies House WebFiling](/automate/companies-house-webfiling), [Texas811 Portal](/automate/texas811-portal).

## Frequently asked questions

### Does the Income Tax e-Filing Portal have an API?

Yes, for e-Return Intermediaries. The published ERI APIs cover login, adding a client with the taxpayer's consent, prefill data, validating and submitting an ITR, e-verification and the acknowledgement. Notices in e-Proceedings and outstanding demands are handled in the portal.

### Where do income tax notices appear on the portal?

Under Pending Actions, e-Proceedings, For your Action. All notices, intimations and letters issued by the Income Tax Department and CPC are made available there, including defective return notices and prima facie adjustments, and responses you have submitted move to For your Information.

### Can I change a response after submitting it in e-Proceedings?

No. A submitted response cannot be edited, updated or withdrawn. Only one Authorized Representative can be active on a proceeding at a time, so decide who answers before you submit.

### How do I respond to an outstanding demand?

Open Pending Actions, then Response to Outstanding Demand. You can disagree with a demand in full or in part, choosing reasons from a list, or use Pay Now / Submit Response. For a partial disagreement, you pay the undisputed portion.

### Is Fous affiliated with the Income Tax Department?

No. Fous is an independent product. You use it with your own e-Filing portal login, and a method reads and does only what that login can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Income Tax e-Filing Portal (Income Tax Department, Government of India). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
