Skip to main content
POST
This endpoint is part of a job-based async workflow. See the job-based API workflow guide for job creation, payload upload, and status polling.

Headers

authorization
string
required

JWT authorization token

x-api-key
string
required

Public key required to authorize API access.

x-api-version
string

Body

application/json
@entity
enum<string>
required
Available options:
in.co.sandbox.tds.compliance.fvu.generate.request
tax_year
string
required

Tax Year (e.g. TY 2026-27)

Pattern: ^TY [0-9]{4}-[0-9]{2}$
Example:

"TY 2026-27"

quarter
enum<string>
required
Available options:
Q1,
Q2,
Q3,
Q4
Example:

"Q1"

form
enum<string>
required

TDS/TCS return form. Use 138 for erstwhile 24Q, 140 for erstwhile 26Q, 144 for erstwhile 27Q, and 143 for erstwhile 27EQ.

Available options:
138,
140,
144,
143
Example:

"140"

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}
filing_type
enum<string>
required

Type of TDS/TCS Return

Available options:
regular,
correction
Example:

"regular"

Response

200 - application/json

200 - OK

code
integer
timestamp
integer
transaction_id
string
data
object