Skip to main content

​
Income Tax Compliance API

The Income Tax Compliance APIs enable seamless integration with the Income Tax Department’s Electronic Return Intermediary (ERI) system for filing Income Tax Returns (ITR), managing taxpayer clients, and handling verification workflows. These APIs provide direct access to the ITD portal for automated tax compliance processes.

​
Key features

ITR Filing

Submit Income Tax Returns electronically through the ERI system with validation and e-verification support.

Client Management

Register, validate, and manage taxpayer clients with OTP-based verification and profile management.

ITR Validation

Validate ITR data before submission to ensure compliance with Income Tax Department requirements.

E-Verification

Verify filed ITRs using Electronic Verification Code (EVC) or Aadhaar OTP for instant confirmation.

Prefill Data

Access pre-filled ITR data from the Income Tax Department to simplify return preparation.

Return Status

Check ITR filing status, download acknowledgements, and track processing updates.

​
How it works

1

Authenticate with ERI system

Use client credentials to authenticate and establish a secure session with the Income Tax Department’s ERI portal.
2

Register or validate clients

Register new taxpayers or validate existing clients using PAN verification and OTP-based authentication.
3

Prepare and validate ITR

Generate prefilled data, prepare ITR forms, and validate submissions before filing.
4

Submit and e-verify

File the ITR electronically and complete e-verification using EVC or Aadhaar OTP.
5

Track and download

Monitor filing status, download acknowledgements, and maintain compliance records.

​
API Categories

​
Client Management APIs

Manage taxpayer clients and authentication:
  • Login: Authenticate with the ERI system
  • Register Client: Register new taxpayers with PAN and contact details
  • Add Client: Add clients to your ERI account
  • Validate Client: Verify client details with OTP
  • Client Profile: Retrieve and update client information

​
ITR Filing APIs

Handle Income Tax Return preparation and submission:
  • Validate ITR: Pre-validate ITR data for compliance
  • Submit ITR: File ITR electronically through ERI
  • E-Verify ITR: Verify filed returns using EVC or OTP
  • Update Verification Mode: Change verification method for submitted ITRs
  • Get Acknowledgement: Retrieve filing status and acknowledgements

​
Prefill APIs

Access pre-filled tax data from ITD:
  • Generate OTP: Request prefill data access
  • Verify OTP: Authenticate and retrieve prefilled ITR information

​
Compliance Requirements

These APIs integrate directly with the Income Tax Department’s ERI system. Ensure you have:
  • Valid ERI registration and credentials
  • Authorized access to client PANs
  • Compliance with ITD data security and privacy requirements
  • Proper consent from taxpayers for data access

​
Error Handling

The APIs return standardized error responses with specific error codes for different failure scenarios:
  • Authentication errors: Invalid credentials or expired sessions
  • Validation errors: ITR data format or business rule violations
  • ITD system errors: Temporary unavailability or processing issues
  • Client verification errors: Invalid PAN or OTP verification failures

​
Rate Limits and Throttling

API calls are subject to rate limits based on your ERI account tier and ITD system capacity. Implement appropriate retry logic with exponential backoff for failed requests.

​
Support

For technical support or questions about Income Tax Compliance APIs:
  • Check the API Reference for detailed endpoint documentation
  • Review the ERI Guidelines from Income Tax Department
  • Contact Sandbox support for integration assistance