Get Prefilled JSON

About

  • This is the first step of the two-step process.
  • This API initiates an OTP Verification to fetch Prefilled JSON data with Taxpayer consent.
  • After, OTP is is sent use the Get Prefill JSON API to obtain the prefill JSON.

Endpoint


About

  • This is the second step of the two-step process to get the Pre-filled JSON.
  • This API initiates an OTP Validation to fetch Prefilled JSON data with Taxpayer consent.
  • The API takes in otp, & transaction_id obtained from calling the previous API. The API also needs the PAN through tax_payer_id.

Endpoint

HTTP Method

Endpoint

Description

POST

/itd/eri/tax-payer/prefilled-json/otp

otp , tax_payer_id, & transaction_id of the first step are taken in to fetch Prefilled JSON.

Path Parameters

Param

Type

Description

Example

tax_payer_id

string

10-character alpha-numeric taxpayer identifier e.g. PAN

EXXXX1111H

Query Parameters

Param

Type

Description

Example

transaction_id

string

Transaction ID obtained from Request Prefilled JSON

db574543-13ad-4bab-ac10-7229df313794

otp

string

OTP sent to Taxpayer Mobile and Email

1234

API EndpointAPI Endpoint


Response

  • data entity

Param

Type

Description

Example

personalInfo

object

Personal Informationb of the assessee.

Look Below :point-down:

bankAccountDtls

object

Bank account details of the assessee.

Look Below :point-down:

verification

object

Look Below :point-down:

Look Below :point-down:

filingStatus

object

Look Below :point-down:

Look Below :point-down:

lastFiledITR

object

Look Below :point-down:

Look Below :point-down:

  • personalInfo entity

Param

Type

Description

Example

dob

string

Date of Birth.

1979-07-31

orgFirmInfo

object

Details of the organization.

Contains details like:
StatusOrCompanyType,AssesseeName,DateOFFormOrIncorp.

aadharCardNo

string

Aadhar Number

MTIzNDEyMzQxMjM0

address

object

Address of the assessee.

Has details such as:
countryCode, mobileNo, localityOrArea, pinCode, residenceName, cityOrTownOr..,stateCOde,phone, emailAddress etc.

assesseeVerPan

string

Pan Number

AFQPG0021A

assesseeVerName

string

Name

John Doe

filingStatus

object

Details regarding residential status

Contains the following:
residentialStatus

assesseeName

object

First and last name of the Assessee.

Contains the following:
firstName, surNameOrOrgName`

pan

string

Pan Number

AFQPG0021A

capacity

string

Capacity of individual

self

status

string

Status of filing

IND

  • bankAccountDtls entity

Param

Type

Description

Example

ifsccode

string

IFSC code of the Assessee's Account

HDFC0001391

bankName

string

Bank Name of the Assessee's Account

HDFC Bank Ltd

bankAccountNo

string

Bank Account Number

1234567890

useForRefund

string

Is this Account used for tax refunds?

true

  • verification entity

Param

Type

Description

Example

assesseeVerName

string

Name of the Assessee

John Doe

assesseeVerPan

string

PAN of the Assessee

EXXXX1122X

  • filingStatus entity

Param

Type

Description

Example

origRetFiledDate

string

Date when the TDS return was filed.

021-09-27

returnFileSec

num

TDS Section underwhich Return was filed.

17

receiptNo

string

Reciept number of the TDS Return filed.

100373810270921

  • lastFiledITR entity

Param

Type

Description

Example

usrDeductUndChapVIAType

object

Object describing if particular section was applied or not.

section80DDB,section80DD, section80U

Schedule80D

object

Object describing if particular section was applied or not.

SeniorCitizenFlag & ParentSeniorCitizenFlag

bankAccountDtls

object

Bank Account details

addtnlBankDetails & foreignBankDetails

totalNumOfMonths

num

Total number of months of employment.

0

employerCategory

string

Employer's chategory respective to TDS.

NA


Did this page help you?