Get E-File Status

Confirm the job status of the E-file API and get acknowledgment on TDS return Filing.

API Pricing Image

Overview

API to check the e-file status of your TDS return by taking in tan,form and job_id and getting their job status.

Problem

  • After posting a job using E-File TDS Return API, businesses would want to check their TDS filing status.

Solution

  • API provides the status of your TDS filing

Endpoint

HTTP MethodResource
GET/tds-compliance/tin-fc/deductors/{tan}/tdsrs/{form}/fvu/e-file

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass the TAN & Job ID to check on your TDS filing status.

Path Parameter

ParamTypeDescriptionExample
tanstringTAN of deductorPDES03028F
formstringTDS Return Form26Q

Query Parameter

ParamTypeDescriptionExample
job_idstringJob ID obtained from uploading the zip file.f24cd229-42c8-43de-af79-8ce2d3c4c3db

Sample CURL Request

curl --request GET \
     --url 'https://api.sandbox.co.in/tds-compliance/tinfc/deductors/PDES03028F/tdsrs/26Q/fvu/e-file?job_id=f24cd229-42c8-43de-af79-8ce2d3c4c3db' \
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxxxxxxxxxxx' \
     --header 'x-api-key: xxxxxxxxxxxxxxxx' \
     --header 'x-api-version: 1.0

Response

ParamTypeDescriptionExample
job_idstringID of the particular zip upload. It will be used later on to check status.f24cd229-42c8-43de-af79-8ce2d3c4c3db
statusstringThe status the particular fvu upload. Possible Values:
JOBQUEUED
JOBDONE
JOBFAILED
JOBQUEUED
messagestringReason for not e-filing TDS return. Will be visible only when the status is JOBFAILED
For possible values, refer to the Annexure - TIN FC
Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
signed_urlstringProvides Acknowledgement of TDS Return. Will be visible only when the status is JOBDONEhttps://...

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Get E-File Status API is not a Paid API, no wallet charge will take place.

Versioning

The API is currently in major version 1.0. Refer to our versioning policies here