Submit Job

API to E-File your TDS return by uploading the zip of FVU and Form27A on a pre-signed URL


Important Links
Run in Postman Start a Free Trial

Job Parameters
Response Entity
Key Type Description Example
job_id string The ID of this job. It will be used later on to check the status. f24cd229-42c8-43de-af79-8ce2d3c4c3db
status string status of the job created
created_at number EPOCH timestamp of when the job was created 1701250588000
fvu_url string Pre-signed URL where you need to
upload zip file of FVU and Form27A
https://.......
tan string TAN of the deductor for which the TDS return is being filed AHMJ01234A
form string TDS return form type 26Q
financial_year string Financial Year FY 2023-24
quarter string Quarter Q4

Test Cases
Test Cases

Test Environment: https://test-api.sandbox.co.in

Run in Postman Response Remark
Test Request 200 The job will be successful
Test Request 200 The job will fail with the message: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
Test Request 200 The job will fail with the message: Unacceptable FVU
Test Request 200 The job will fail with the message: Invalid Archive
Test Request 200 The job will fail with the message: Invalid Number of entries in Archive: 1
Test Request 200 The job will fail with the message: Form Type Mismatch
Test Request 200 The job will fail with the message: Quarter Mismatch
Test Request 200 The job will fail with the message: Barcode Mismatch
Test Request 200 The job will fail with the message: Financial Year Mismatch
Test Request 200 The job will fail with the message: TAN Mismatch
Test Request 200 The job will fail with the message: FVU Missing
Test Request 200 The job will fail with the message: Form 27A missing
Test Request 422 Invalid TAN Pattern
Test Request 422 Invalid Form

Body Params
string
required
Defaults to in.co.sandbox.tds.compliance.e-file.request

Entity name

string
enum
required

Quarter (e.g. Q2)

Allowed:
string
required

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

string
enum
required

TDS/TCS return form

Allowed:
string
required

Financial Year (e.g. FY 2022-23)

Headers
string
required

JWT Authorization token

string
required

API key for identification

string

API Version

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json