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
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
required
string
Response
200: OK
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBQUEUED"
}

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
required
string
Query Parameters
transaction_id
required
string
Response
200: OK
JOBDONE (JSON)
JOBDONE (PDF)
JOBQUEUED
JOBFAILED
JOBDONE (JSON)
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"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)
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBDONE",
"data": {
"signed_url": "https://..."
}
}
JOBQUEUED
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBQUEUED",
}
JOBFAILED
{
"transaction_id": "85dcf64b-217b-4b28-afdb-d99c9d5452b1",
"status": "JOBFAILED",
}