Skip to main content
POST
/
tds
/
analytics
/
potential-notices
Create TDS Potential Notice Job
curl --request POST \
  --url https://api.sandbox.co.in/tds/analytics/potential-notices \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "<string>",
  "quarter": "Q1",
  "tan": "<string>",
  "form": "24Q",
  "financial_year": "FY 2024-25"
}
'
{ "code": 200, "timestamp": 1763633700000, "transaction_id": "1c1e4905-d07e-4c51-b8c5-1163050ded7f", "data": { "@entity": "in.co.sandbox.tds.analytics.potential_notices.job", "job_id": "1c1e4905-d07e-4c51-b8c5-1163050ded7f", "tan": "AHMA09719B", "quarter": "Q4", "financial_year": "FY 2023-24", "form": "26Q", "status": "created", "created_at": 1716515767000, "json_url": "https://test-api.sandbox.co.in/tds/analytics/in-co-sandbox-tds-analytics-potential-notices-test/tan/financial_year/quarter/80716d9a-4aa0-4905-8ff1-0aca61042a0e.json" } }
This endpoint is part of a job-based async workflow. See the job-based API workflow guide for job creation, payload upload, and status polling.

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
required
Allowed value: "in.co.sandbox.tds.analytics.potential_notice.request"
ā€‹
quarter
enum<string>
required

Quarter for which TDS is being filed

Available options:
Q1,
Q2,
Q3,
Q4
ā€‹
tan
string
required

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

Pattern: [A-Z]{4}[0-9]{5}[A-Z]{1}
ā€‹
form
enum<string>
required

TDS return form

Available options:
24Q,
26Q,
27Q
ā€‹
financial_year
string
required

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

Example:

"FY 2024-25"

Response

200 - OK

ā€‹
code
integer
ā€‹
timestamp
integer
ā€‹
transaction_id
string
ā€‹
data
object