ITR Verification API

Request and response

List the income tax returns filed against a PAN. This call is billed when it returns a successful result.

Request body

Example requests

curl -X POST "https://verification.techinnoverz.com/api/v1/identity-kyc/itr" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "pan": "ABCPE1234F",
  "consent": "Y",
  "referenceId": "app_20915"
}'

const res = await fetch("https://verification.techinnoverz.com/api/v1/identity-kyc/itr", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "pan": "ABCPE1234F",
    "consent": "Y",
    "referenceId": "app_20915"
  }),
});
const result = await res.json();

import requests

res = requests.post(
    "https://verification.techinnoverz.com/api/v1/identity-kyc/itr",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "pan": "ABCPE1234F",
        "consent": "Y",
        "referenceId": "app_20915",
    },
    timeout=15,
)
result = res.json()

200 response — status "found"

{
  "status": "found",
  "data": {
    "pan": "ABCPE1234F",
    "filings": [
      {
        "assessmentYear": "2024",
        "acknowledgementNumber": "583864160040724",
        "filedAt": null
      },
      {
        "assessmentYear": "2023",
        "acknowledgementNumber": "571096020200723",
        "filedAt": null
      }
    ]
  },
  "source": "provider",
  "dataAsOf": "2026-11-03T09:30:00.000Z",
  "referenceId": "app_20915",
  "billing": {
    "charged": true,
    "walletBalance": "12450.00"
  },
  "txnId": "txn_8c31ba90",
  "livemode": true
}

Fields returned in data

Error codes

Errors return a non-200 HTTP status and the same envelope, so your retry logic and your reconciliation agree.

{
  "status": "error",
  "error": {
    "code": "NO_DATA",
    "message": "No record found for the given input. Not charged."
  },
  "billing": {
    "charged": false
  },
  "txnId": "txn_8c31ba91",
  "livemode": true
}

Billing

You are charged only on successful hits. Failed, no-data and error calls are free.

Every response carries billing.charged and your remaining billing.walletBalance. Per-hit pricing is set on your rate card; book a demo to get yours.

Related checks

• PAN Verification API — Verify PAN card details and status against Income Tax Department records.
• PAN Advanced Verification API — Verify a PAN and also get its holder type and whether it is linked to Aadhaar.
• PAN Plus Verification API — Everything in PAN Advanced plus the PAN status, allotment date, authorised signatory of a company PAN and whether the holder is a sole proprietor, director or salaried.
• Voter ID Verification API — Verify EPIC (Voter ID) details against Election Commission of India records.
• Driving Licence Verification API — Verify driving licence number, validity and vehicle class against Parivahan records.
• Driving Licence Advanced Verification API — Verify a driving licence and also get split addresses, vehicle category dates, blood group and endorsement details.
• Passport Verification API — Validate a passport file number and date of birth and get the holder's name, passport number and application dates.
• DigiLocker Verification API — Start a DigiLocker consent flow, then fetch the person's verified documents and demographics once they approve.
• Face Liveness Verification API — Check whether a selfie shows a live person, with quality signals such as blur, mask, alignment and occlusion.
• Face Match Verification API — Compare a live selfie with a face on an identity document and return whether they match, with confidence and quality signals.