get https://api.sandbox.co.in/tds/compliance/e-file
API to check the status of the e-filed TDS return.
| 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 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 |