ITR Filing Details — Income & Tax Summary

Get parsed ITR data — gross income, deductions, tax paid, refund status, and filing details for any registered PAN.

curl -X GET "https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -H "x-api-key: YOUR_API_KEY"

import requests
import json

url = "https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN (JWT)",
  "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN (JWT)",
  "x-api-key": "YOUR_API_KEY"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
    req.Header.Set("x-api-key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'

response = http.request(request)
puts response.body

{
  "code": 200,
  "timestamp": 1760438759600,
  "transaction_id": "94945247VWTB04979764462361101099",
  "sub_code": "SUCCESS",
  "message": "ITR details fetched successfully.",
  "data": {
    "gender": null,
    "name": "RAHUL KUMAR SHARMA",
    "fathers_name": "RAJESH KUMAR SHARMA",
    "email": "user@example.com",
    "pincode": 447224,
    "aadhaar_no": "688198328017",
    "mobile_no": "9876543210",
    "address": "610/C, STREET NO 16, VASANT VIHAR, PUNE, PUNE",
    "income": {
      "company_name": "NORTHSTAR SYSTEMS PRIVATE LIMITED (WOPO73798E)",
      "company_address": "11, INDUSTRIAL AREA, PHASE 4, EAST DELHI, 576279",
      "income_salary": 150000,
      "income_hp": 0,
      "gross_income": 233610,
      "total_income": 233520
    },
    "gross_income": 233610,
    "itr_type": "itr_2",
    "dob": "1985-06-15",
    "doi": null,
    "raw_itr": {
      "ITR": {
        "ITR2": {
          "PartA_GEN1": {
            "PersonalInfo": {
              "AssesseeName": {
                "FirstName": "RAHUL",
                "MiddleName": "KUMAR",
                "SurNameOrOrgName": "SHARMA"
              },
              "PAN": "PKOXY0452N",
              "Address": {
                "ResidenceNo": "610/C",
                "RoadOrStreet": "STREET NO 16",
                "LocalityOrArea": "VASANT VIHAR",
                "CityOrTownOrDistrict": "PUNE",
                "StateCode": "09",
                "CountryCode": "91",
                "PinCode": 447224,
                "CountryCodeMobile": 91,
                "MobileNo": 9876543210,
                "EmailAddress": "user@example.com"
              },
              "DOB": "1985-06-15",
              "Status": "I",
              "AadhaarCardNo": "688198328017"
            },
            "FilingStatus": {
              "CompDirectorPrvYr": {
                "CompDirectorPrvYrDtls": [
                  {
                    "NameOfCompany": "NORTHSTAR SYSTEMS PRIVATE LIMITED",
                    "PAN": "PGARA5513G",
                    "DIN": "01151691"
                  }
                ]
              }
            }
          },
          "ScheduleS": {
            "Salaries": [
              {
                "NameOfEmployer": "NORTHSTAR SYSTEMS PRIVATE LIMITED (WOPO73798E)",
                "TANofEmployer": "WOPO73798E",
                "AddressDetail": {
                  "AddrDetail": "11, INDUSTRIAL AREA, PHASE 4",
                  "CityOrTownOrDistrict": "EAST DELHI",
                  "PinCode": 447224
                }
              }
            ]
          },
          "PartB_TTI": {
            "Refund": {
              "BankAccountDtls": {
                "AddtnlBankDetails": [
                  {
                    "IFSCCode": "YKHN0464722",
                    "BankName": "KOTAK MAHINDRA BANK",
                    "BankAccountNo": "76741181450440",
                    "AccountType": "SB"
                  },
                  {
                    "IFSCCode": "FNBI0289587",
                    "BankName": "PUNJAB NATIONAL BANK",
                    "BankAccountNo": "294850471261",
                    "AccountType": "SB"
                  }
                ]
              }
            }
          },
          "ScheduleTDS1": {
            "TDSonSalary": [
              {
                "EmployerOrDeductorOrCollectDetl": {
                  "TAN": "WOPO73798E",
                  "EmployerOrDeductorOrCollecterName": "NORTHSTAR SYSTEMS PRIVATE LIMITED"
                }
              }
            ]
          },
          "Verification": {
            "Declaration": {
              "AssesseeVerName": "RAHUL KUMAR SHARMA",
              "FatherName": "RAJESH KUMAR SHARMA",
              "AssesseeVerPAN": "PKOXY0452N"
            },
            "Capacity": "S"
          }
        }
      }
    }
  }
}

{
  "code": 422,
  "timestamp": 1783597713450,
  "transaction_id": "12012830907c41d5920cd875bbb7c1f2",
  "sub_code": "INVALID_INPUT",
  "message": "Given Itr-id or Itr-client-id not found in client"
}

GET

/v1/verification/itr/get-itr-details

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (JWT)

Bearer Tokenstring

Required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

API Key (header: x-api-key)

x-api-keystring

Required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header

x-api-keystring

Required

API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Query Parameters

itr_client_idstring

Required

Example:

client_a73af0b7accc4c3fbaa3dd2dc2cab550

itr_idstring

Required

Example:

itr_a73af0b7accc4c3fbaa3dd2dc2cab550

Responses

codeinteger

Required

timestampinteger

transaction_idstring

sub_codestring

messagestring

Required

dataobject

Overview

This API retrieves comprehensive Income Tax Return details for a specific client. The response includes personal identifiers (name, father's name, date of birth, gender), contact information (email, mobile number, address, pincode), Aadhaar number, financial details (income, gross income), tax filing specifics (ITR type, date of issue, filing date), acknowledgement number, and raw ITR data.

You need an authorized access token to access any of the Platform APIs. One access token is valid for only 24 hours. After expiration, you can renew the token by using the Authorize endpoint to receive a fresh access token.

Was this page helpful?

curl -X GET "https://production.deepvue.tech/v1/verification/itr/get-itr-details?itr_client_id=client_a73af0b7accc4c3fbaa3dd2dc2cab550&itr_id=itr_a73af0b7accc4c3fbaa3dd2dc2cab550" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \ -H "x-api-key: YOUR_API_KEY"

{ "code": 200, "timestamp": 1760438759600, "transaction_id": "94945247VWTB04979764462361101099", "sub_code": "SUCCESS", "message": "ITR details fetched successfully.", "data": { "gender": null, "name": "RAHUL KUMAR SHARMA", "fathers_name": "RAJESH KUMAR SHARMA", "email": "user@example.com", "pincode": 447224, "aadhaar_no": "688198328017", "mobile_no": "9876543210", "address": "610/C, STREET NO 16, VASANT VIHAR, PUNE, PUNE", "income": { "company_name": "NORTHSTAR SYSTEMS PRIVATE LIMITED (WOPO73798E)", "company_address": "11, INDUSTRIAL AREA, PHASE 4, EAST DELHI, 576279", "income_salary": 150000, "income_hp": 0, "gross_income": 233610, "total_income": 233520 }, "gross_income": 233610, "itr_type": "itr_2", "dob": "1985-06-15", "doi": null, "raw_itr": { "ITR": { "ITR2": { "PartA_GEN1": { "PersonalInfo": { "AssesseeName": { "FirstName": "RAHUL", "MiddleName": "KUMAR", "SurNameOrOrgName": "SHARMA" }, "PAN": "PKOXY0452N", "Address": { "ResidenceNo": "610/C", "RoadOrStreet": "STREET NO 16", "LocalityOrArea": "VASANT VIHAR", "CityOrTownOrDistrict": "PUNE", "StateCode": "09", "CountryCode": "91", "PinCode": 447224, "CountryCodeMobile": 91, "MobileNo": 9876543210, "EmailAddress": "user@example.com" }, "DOB": "1985-06-15", "Status": "I", "AadhaarCardNo": "688198328017" }, "FilingStatus": { "CompDirectorPrvYr": { "CompDirectorPrvYrDtls": [ { "NameOfCompany": "NORTHSTAR SYSTEMS PRIVATE LIMITED", "PAN": "PGARA5513G", "DIN": "01151691" } ] } } }, "ScheduleS": { "Salaries": [ { "NameOfEmployer": "NORTHSTAR SYSTEMS PRIVATE LIMITED (WOPO73798E)", "TANofEmployer": "WOPO73798E", "AddressDetail": { "AddrDetail": "11, INDUSTRIAL AREA, PHASE 4", "CityOrTownOrDistrict": "EAST DELHI", "PinCode": 447224 } } ] }, "PartB_TTI": { "Refund": { "BankAccountDtls": { "AddtnlBankDetails": [ { "IFSCCode": "YKHN0464722", "BankName": "KOTAK MAHINDRA BANK", "BankAccountNo": "76741181450440", "AccountType": "SB" }, { "IFSCCode": "FNBI0289587", "BankName": "PUNJAB NATIONAL BANK", "BankAccountNo": "294850471261", "AccountType": "SB" } ] } } }, "ScheduleTDS1": { "TDSonSalary": [ { "EmployerOrDeductorOrCollectDetl": { "TAN": "WOPO73798E", "EmployerOrDeductorOrCollecterName": "NORTHSTAR SYSTEMS PRIVATE LIMITED" } } ] }, "Verification": { "Declaration": { "AssesseeVerName": "RAHUL KUMAR SHARMA", "FatherName": "RAJESH KUMAR SHARMA", "AssesseeVerPAN": "PKOXY0452N" }, "Capacity": "S" } } } } } }