Skip to main content
POST
/
tds
/
compliance
/
e-file
/
search
Fetch Jobs
curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/e-file/search \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.e-file.search"
}
'
{
  "code": 200,
  "timestamp": 1763035357079,
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.e-file.paginated_list",
    "items": [
      {
        "created_at": 1763034775467,
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "f139447f-07c0-4de1-9f35-0224e253aeec",
        "tan": "AHMA09719B",
        "tax_year": "TY 2026-27",
        "quarter": "Q2",
        "form": "138",
        "filing_type": "regular",
        "status": "created"
      },
      {
        "created_at": 1763034374362,
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "6cc8a10e-6c09-4c6f-9bfe-d10b6f6afbb0",
        "tan": "SRTH05889C",
        "tax_year": "TY 2026-27",
        "quarter": "Q2",
        "form": "140",
        "filing_type": "regular",
        "status": "created"
      },
      {
        "created_at": 1745588854631,
        "updated_at": 1745588884436,
        "@entity": "in.co.sandbox.tds.compliance.e-file.job",
        "job_id": "8566e974-9f6f-49ca-96cb-c75680261405",
        "tan": "SRTH05889C",
        "tax_year": "TY 2026-27",
        "quarter": "Q2",
        "form": "140",
        "filing_type": "regular",
        "status": "succeeded"
      }
    ]
  },
  "transaction_id": "a109f017-10ae-44aa-ade7-3902a8cddd6b"
}

Headers

authorization
string
required

JWT access token

x-api-key
string
required

API key for identification

x-api-version
string

Body

application/json
@entity
enum<string>
required
Available options:
in.co.sandbox.tds.compliance.e-file.search
tan
string

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

quarter
enum<string>

Quarter (e.g. Q2)

Available options:
Q1,
Q2,
Q3,
Q4
form
enum<string>

TDS/TCS return form. Use 138 for erstwhile 24Q, 140 for erstwhile 26Q, 144 for erstwhile 27Q, and 143 for erstwhile 27EQ.

Available options:
138,
140,
144,
143
tax_year
string

Tax Year (e.g. TY 2026-27)

Pattern: ^TY [0-9]{4}-[0-9]{2}$
Example:

"TY 2026-27"

from_date
integer

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

to_date
integer

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

page_size
integer

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

Response

200 - application/json

200 - OK

code
integer
timestamp
integer
data
object
transaction_id
string