Get ITR Data for Assessment Year

API reference

curl -X POST "https://__mock__/verification/v2/itr/get_data_by_assessment_year" \  -H "Content-Type: application/json" \  -d '{}'

{
  "itr_data": {}
}

{
  "detail": {},
  "message": "string"
}

{
  "detail": {},
  "message": "string"
}

{
  "error": "string"
}

Overview

Call POST /verification/v2/itr/get_data_by_assessment_year from your backend when you need ITR data for a specific assessment year rather than only the latest filing. Send Authorization: Bearer <token> and a JSON body with pan and year (assessment year string as your integration uses, for example 2024-25), per OpenAPI.

On 200 OK, the response includes itr_data. Use this when your policy requires a historical year view.

Key features

• Year-scoped: Targets one assessment year explicitly.
• Server-side only: Keep Bearer auth on trusted servers.
• Complements latest fetch: Use with Get ITR Data when you need both latest and historical views.

Implementation

Step 1: Call from your backend

POST /verification/v2/itr/get_data_by_assessment_year HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json

{
  "pan": "ABCDE1234F",
  "year": "2024-25"
}

Step 2: Use itr_data

Parse and store per your compliance rules. Avoid verbose logging.

Error handling

Benefits

• Supports year-specific income verification workflows.
• Same auth model as other ITR endpoints.

Next steps

• Get ITR Data
• Get OTP
• Verification API index