Skip to main content
POST
/
tds
/
compliance
/
fvu
/
generate
Create FVU Generation Job
curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/fvu/generate \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "@entity": "in.co.sandbox.tds.compliance.fvu.generate.request",
  "financial_year": "FY 2024-25",
  "quarter": "Q1",
  "form": "26Q",
  "tan": "<string>",
  "filing_type": "regular"
}'
{
"code": 200,
"timestamp": 1763362637000,
"transaction_id": "e2b9145f-69d5-4bbe-a6de-be6fc08b426f",
"data": {
"@entity": "in.co.sandbox.tds.compliance.fvu.generate.job",
"job_id": "4ef92975-aea8-4628-9eaa-18eb439c13d9",
"tan": "AHMA09719B",
"financial_year": "FY 2024-25",
"quarter": "Q3",
"form": "24Q",
"filing_type": "regular",
"status": "created",
"created_at": 1763362637000,
"txt_file_upload_url": "https://test-api.sandbox.co.in/tds/compliance/tan/financial_year/quarter/form/e61fd4d6-dedd-4803-ab45.txt",
"csi_file_upload_url": "https://test-api.sandbox.co.in/tds/compliance/tan/financial_year/quarter/form/e61fd4d6-dedd-4803-ab45.csi"
}
}

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
financial_year
string
required

Financial Year (e.g. FY 2024-25)

Example:

"FY 2024-25"

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

"Q1"

form
enum<string>
required
Available options:
26Q,
27Q,
24Q,
27EQ
Example:

"26Q"

tan
string
required

TAN of deductor/collector. Regular Expression: [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 - OK

code
integer
timestamp
integer
transaction_id
string
data
object