Search E-File TDS Return Jobs

post

https://api.sandbox.co.in/tds/compliance/e-file/search

Fetch all TDS/TCS E-file Jobs through this API.

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
receipt_number	number	TDSR filing receipt number.	123456789012345
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

Body Params

@entity

string

required

Defaults to in.co.sandbox.tds.compliance.e-file.search

Entity Name

tan

string

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

quarter

string

enum

Quarter (e.g. Q2)

Allowed:

form

string

enum

TDS/TCS return form

Allowed:

financial_year

string

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

from_date

int32

Date from which jobs are to be fetched. Value in EPOCH timestamp

to_date

int32

Date till which jobs are to be fetched. Value in EPOCH timestamp

page_size

int32

Number of records in the API response. Maximum allowed size is 50

last_evaluated_key

string

Base64 encoding of the stringified JSON object, which includes x-api-key, created_at, and job_id

Headers

authorization

string

required

JWT access token

x-api-key

string

required

API key for identification

x-api-version

string

API version

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200