Skip to main content
POST
/
tds
/
analytics
/
potential-notices
/
search
Fetch Jobs
curl --request POST \
  --url https://api.sandbox.co.in/tds/analytics/potential-notices/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "@entity": "<string>",
  "tan": "<string>",
  "quarter": "Q1",
  "form": "24Q",
  "financial_year": "FY 2024-25",
  "from_date": 123,
  "to_date": 123,
  "page_size": 49,
  "last_evaluated_key": "<string>"
}'
{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "data": {
    "@entity": "<string>",
    "items": [
      {
        "@entity": "<string>",
        "job_id": "<string>",
        "tan": "<string>",
        "financial_year": "<string>",
        "quarter": "<string>",
        "form": "<string>",
        "created_at": 123,
        "updated_at": 123,
        "status": "<string>",
        "return_receipt_number": 123
      }
    ],
    "last_evaluated_key": "<string>"
  }
}

Headers

x-api-key
string
required

API key for identification

Authorization
string
required

JWT access token

x-api-version
string

API Version

Body

application/json
@entity
string
Allowed value: "in.co.sandbox.tds.analytics.potential_notice.jobs.search"
tan
string

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

quarter
enum<string>

Quarter for which TDS is being filed

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

TDS return form

Available options:
24Q,
26Q,
27Q
financial_year
string

Financial Year for which TDS is being filed. (eg. FY 2024-25)

Example:

"FY 2024-25"

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

Required range: x <= 50
last_evaluated_key
string

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

Response

default - application/json

200 - Success

code
integer
timestamp
integer
transaction_id
string
data
object