Java Developer for Microservice — ITR & AIS

Java Spring Boot Microservice — ITR Portal Login + AIS &
26AS Data Fetch
Project Type: Backend Microservice Development
Timeline: 4–6 Weeks (MVP)
Date Posted: April 2026
Project Description
Looking for an experienced Java developer to build a backend microservice that:
Logs into the Income Tax e-Filing portal ( incometax.gov.in ) programmatically ( We have python based script we will share the script to login)
Extracts the session token post-login
Fetches AIS (Annual Information Statement) and Form 26AS from the TRACES
portal ( tdscpc.gov.in )
Exposes the data via a REST API secured with JWT
The service must handle OTP/MFA relay, auto token refresh, and be built to scale
horizontally.
Key Requirements
Java 21 + Spring Boot 3.x
Redis for encrypted session/token caching (TTL-managed)
Resilience4j — circuit breaker, retry, rate limiting
REST endpoints for login, AIS fetch, 26AS fetch, PDF download, session refresh
JWT-secured API with structured JSON responses
Docker + Kubernetes ready (Helm chart)
Structured logging, OpenTelemetry tracing, Prometheus metrics
WireMock-based integration tests + 80%+ unit test coverage
Compatible with TRACES 2.0 portal (launched April 2026)
1.
2.
3.
4.
•
•
•
•
•
•
•
•
•
REST Endpoints Required
Method Endpoint Description
POST /api/v1/auth/login Initiate ITR portal login
POST /api/v1/auth/otp OTP relay for MFA
POST /api/v1/auth/logout Invalidate session
GET /api/v1/ais/{pan}/{ay} Fetch AIS data
GET /api/v1/26as/{pan}/{fy} Fetch Form 26AS (JSON)
GET /api/v1/26as/{pan}/{fy}/pdf Download Form 26AS (PDF)
GET /api/v1/session/status Check token validity
POST /api/v1/session/refresh Force token refresh
Tech Stack
Component Technology
Language / Framework Java 21 + Spring Boot 3.x
Session/Token Cache Redis 7 (AES-256 encrypted, TTL-managed)
Resilience Resilience4j (Circuit Breaker, Retry, Rate Limiter)
Security Spring Security + JWT
Observability OpenTelemetry + Micrometer (Prometheus)
Deployment Docker + Kubernetes (Helm chart)
Testing JUnit 5, Mockito, WireMock, Testcontainers
API Docs Swagger / OpenAPI 3
Deliverables
Complete source code (GitHub repository)
Docker image + Helm chart for Kubernetes deployment
Swagger/OpenAPI documentation
Full test suite (unit + integration)
•
•
•
•
README with setup and deployment instructions
Skills Required
Java · Spring Boot · REST API Design · Redis · Resilience4j · Docker · Kubernetes · JWT
Security · OpenTelemetry · HTTP Session Automation · Web Scraping
Key Risks to Address
Risk Expected Mitigation
Portal CAPTCHA / bot-detection Request throttling per PAN; ERI API fallback
OTP/MFA blocking automation Async OTP relay endpoint in API
TRACES 2.0 migration changes Support both old and new TRACES response formats
Compliance Notes
No taxpayer credentials to be stored in any database or log
Service is pass-through only — no AIS/26AS data persistence
Must comply with DPDP Act 2023 and IT Act 2000
Only for authorized/taxpayer-consented use cases
Note to Bidders
Please mention your experience with Indian government portal integrations or similar
session-based HTTP automation projects. Prior experience with TRACES portal, ERI APIs,
or income tax portal automation is a strong plus.
For queries, contact the project owner before placing a bid.