Create FVU generation job - Sandbox

curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/fvu/generate \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.fvu.generate.request",
  "tax_year": "TY 2026-27",
  "form": "138",
  "quarter": "Q1",
  "tan": "AHMQ00112A",
  "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",
    "tax_year": "TY 2026-27",
    "quarter": "Q3",
    "form": "138",
    "filing_type": "regular",
    "status": "created",
    "created_at": 1763362637000,
    "txt_file_upload_url": "https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/upload/file",
    "csi_file_upload_url": "https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/upload/file"
  }
}

POST

/

tds

/

compliance

/

fvu

/

generate

curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/fvu/generate \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.fvu.generate.request",
  "tax_year": "TY 2026-27",
  "form": "138",
  "quarter": "Q1",
  "tan": "AHMQ00112A",
  "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",
    "tax_year": "TY 2026-27",
    "quarter": "Q3",
    "form": "138",
    "filing_type": "regular",
    "status": "created",
    "created_at": 1763362637000,
    "txt_file_upload_url": "https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/upload/file",
    "csi_file_upload_url": "https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/upload/file"
  }
}

After creating the job, upload these files using HTTP PUT:

Return text file → data.txt_file_upload_url
CSI file → data.csi_file_upload_url
Consolidated file for correction returns → data.conso_file_upload_url

Save data.job_id to check the validation result.

For HTTP PUT upload instructions, see the job-based API workflow.

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

Show child attributes