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}/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 txt and csi 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/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 txt and csi uploaded. 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 2.0. Refer to the below table for the versioning history of this API along with the Changelog.

VersionDescriptionLink to the endpoint
2.0Inclusion of form type in the path parameter.API Endpoint
1.0This is the first version of the API.API Endpoint

Refer to our versioning policies here