Skip to main content
POST
Use the CSI download API to retrieve a Challan Status Inquiry file for TDS or TCS return validation.
  1. Request an OTP with the TAN, mobile number, challan dates, consent and reason.
  2. Use the returned data.reference_id and OTP to verify the CSI OTP and download the file.
An HTTP 200 response can also contain an error. Check data.message and continue only when the response includes data.reference_id.

Headers

​
authorization
string
required

JWT access token

​
x-api-key
string
required

API key for identification

​
x-api-version
string

Body

application/json
​
@entity
enum<string>
required
Available options:
in.co.sandbox.tds.compliance.deductors.otp.request
​
tan
string
required

TAN of deductor/collector. Regular Expression: [A-Z]{4}[0-9]{5}[A-Z]{1}

Pattern: [A-Z]{4}[0-9]{5}[A-Z]{1}
​
mobile_number
string
required

Mobile Number to send the OTP. Pattern: [1-9]{1}[0-9]{9}

Pattern: [1-9]{1}[0-9]{9}
​
from
integer
required

Date from which challan details are to be fetched. Value in EPOCH timestamp

​
to
integer
required

Date till which challan details are to be fetched. Value in EPOCH timestamp

​
consent
string
required

Consent of the end-user to get their information. Possible values: Y or y

​
reason
string
required

Indicate the purpose. Min length: 20 characters

Response

Check the response body for the result. HTTP 200 can also contain an application error in data.message.

​
timestamp
integer
​
transaction_id
string
​
data
object
​
code
integer