ITR-V

The ITR-V (Income Tax Return – Verification) is an acknowledgment form that a taxpayer receives on the successful submission of ITR. This ITR-V is widely used as proof of income of a person.

Fetch ITR-V

This API allows you to fetch the ITR-V of a client for a given financial period in JSON, PDF, or XML formats.

A user can be added as a client by calling the below API

post
Fetch ITR-V request

https://api.sandbox.co.in/itd/eri/tax-payers/:pan/itrs/:assessment_year/itr-v
Initiate Fetch ITR-V request for a given financial year
Request
Response
Request
Path Parameters
pan
required
string
assessment_year
required
string
Headers
accept
required
string
possible values: application/json, application/pdf
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
optional
string
Response
200: OK
{
"code": 200,
"timestamp": 1616223735111,
"transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"job":{
"job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"status": "JOBQUEUED"
}
}
422: Unprocessable Entity
Invalid Pan pattern
Invalid assessment year
Invalid Pan pattern
{
"code": 422,
"timestamp": 1616223715004,
"transaction_id": "316668b9-34cd-4a5b-aa8e-d4f13bde9a50",
"message": "Invalid Pan pattern"
}
Invalid assessment year
{
"code": 422,
"timestamp": 1616223684319,
"transaction_id": "e2b9752a-711e-40a1-9a9c-72f3111f8a6d",
"message": "Invalid assessment year: 201a"
}

get
Get ITR-V

https://api.sandbox.co.in/itd/eri/tax-payers/:pan/itrs/:assessment_year/itr-v?transaction_id={transaction_id}
Obtain the ITR-V of the client in JSON or PDF format
Request
Response
Request
Path Parameters
pan
required
string
assessment_year
required
string
Headers
accept
required
string
possible values: application/json, application/pdf
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
optional
string
Query Parameters
job_id
required
string
Response
200: OK
JOBDONE (JSON)
JOBDONE (PDF)
JOBQUEUED
JOBFAILED
JOBDONE (JSON)
{
"code": 200,
"timestamp": 1616223781341,
"transaction_id": "fd096e71-faa0-419b-9133-85f53ca658d7",
"job": {
"job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"status": "JOBDONE",
"data": {
"status": "e-verified",
"assessment_year": "AY 2019-20",
"itr_form": "ITR-1",
"personal_information": {
"name": "John Doe",
"pan": "XXXPX1234A",
"flat_door_block_no": "105, Greenview Apartment, Swastik Soceity",
"status": "Individual",
"name_of_premises_building_village": "",
"road_street_post_office": "",
"area_locality": "Palanpur",
"town_city_district": "Surat",
"state": "Gujarat",
"pin_zipcode": "395009",
"filed_us": "139(1)-On or before due date"
},
"assessing_officer_details_ward_circle": "WARD 1(3)(7), SURAT",
"acknowledgement_number": "999958980081019",
"computation_of_income_and_tax": {
"gross_total_income": "62000",
"total_deductions_under_chapter_vi_a": "0",
"total_income": "62000",
"deemed_total_income_under_amt_mat": "0",
"current_year_loss": "0",
"net_tax_payable": "0",
"interest_and_fee_payable": "0",
"total_tax_interest_and_fee_payable": "0",
"taxes_paid": {
"advance_tax": "0",
"tds": "0",
"tcs": "0",
"self_assessmennt_tax": "0",
"total_taxes_paid": "0"
},
"tax_payable": "0",
"refund": "0",
"exempt_income": {
"agriculture": "0",
"others": "0"
}
},
"submission_date": "26-08-2019 14:57:06",
"submitted_from_ip_address": "192.168.9.9",
"verified_from_ip_address": "192.168.9.9",
"verified_by": "John Doe",
"pan": "XXXPX1234A",
"verification_date": "28-08-2019 08:51:45",
"evc": "PGZTCESJ7I",
"generated_through": "Aadhaar OTP",
"signed_url": "https://..."
}
}
}
JOBDONE (PDF)
{
"code": 200,
"timestamp": 1616223781341,
"transaction_id": "fd096e71-faa0-419b-9133-85f53ca658d7",
"job": {
"job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"status": "JOBDONE",
"data": {
"signed_url": "https://..."
}
}
}
JOBQUEUED
{
"code": 200,
"timestamp": 1616223746147,
"transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"job": {
"job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"status": "JOBQUEUED"
}
}
JOBFAILED
{
"code": 200,
"timestamp": 1616223634551,
"transaction_id": "bff26405-f3a0-4fe6-b8fb-05622b3e447e",
"job": {
"job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"status": "JOBFAILED",
"data": {
"message": "No return found for assessment year: AY 2201-02"
}
}
}