Poll Job

API to check the status of the e-filed TDS return.


Important Links
Run in Postman Start a Free Trial

Response Entity
Response Entity
Key Type Description Example
job_id string ID of the particular txt and csi uploaded. f24cd229-42c8-43de-af79-8ce2d3c4c3db
status string The status of the particular fvu upload. Possible Values:
created, queued, failed, succeeded.
succeeded
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
filing_type string TDSR Filing Type. original
receipt_number number TDSR filing receipt number. 123456789012345
receipt_url string Provides acknowledgment of TDS Return. Will be visible only when the status is succeeded. View Receipt
fvu_url string Provides FVU File of TDS Return. Will be visible only when the status is succeeded. https://...
form27a_url string Provides Form 27A of TDS Return. Will be visible only when the status is succeeded. https://...
message string Reason for not e-filing TDS return. Will be visible only when the status is failed. For possible values, refer to the TIN-FC Error Codes & Messages. Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished.
created_at number EPOCH timestamp of when the job was created. 1701250588000
updated_at number EPOCH timestamp of when the job was last updated. 1701250698000

Test Cases
Test Cases

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

Run in Postman Response Remark
Test Request 200 Job Queued Response
Test Request 200 Job Done Response
Test Request 200 Job Failed: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
Test Request 200 Job Failed: Unacceptable FVU
Test Request 200 Job Failed: Invalid Archive
Test Request 200 Job Failed: Invalid Number of entries in Archive: 1
Test Request 200 Job Failed: Form Type Mismatch
Test Request 200 Job Failed: Quarter Mismatch
Test Request 200 Job Failed: Barcode Mismatch
Test Request 200 Job Failed: Financial Year Mismatch
Test Request 200 Job Failed: TAN Mismatch
Test Request 200 Job Failed: FVU Missing
Test Request 200 Job Failed: Form 27A missing

Language
Click Try It! to start a request and see the response here!