Submit Job

Submit TDS Certificate Download Job

curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.traces.credentials",
  "username": "<string>",
  "password": "<string>",
  "tan": "<string>",
  "security_captcha": {
    "@entity": "in.co.sandbox.tds.compliance.traces.credentials.security_captcha",
    "quarter": "Q1",
    "financial_year": "FY 2024-25",
    "form": "24Q",
    "bsr_code": "<string>",
    "challan_date": 123,
    "challan_serial_no": "<string>",
    "provisional_receipt_number": "<string>",
    "challan_amount": 123,
    "unique_pan_amount_combination_for_challan": [
      [
        "<string>"
      ]
    ]
  },
  "remember_me": true
}
'

{
  "code": 200,
  "timestamp": 1716870600000,
  "transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.certificate.job",
    "job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
    "tan": "AHMA09719B",
    "quarter": "Q4",
    "financial_year": "FY 2023-24",
    "form": "24Q",
    "status": "created",
    "remember_me": false,
    "created_at": 1716870600000
  }
}

POST

tds

compliance

traces

deductors

forms

{certificate_type}

Submit TDS Certificate Download Job

curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.traces.credentials",
  "username": "<string>",
  "password": "<string>",
  "tan": "<string>",
  "security_captcha": {
    "@entity": "in.co.sandbox.tds.compliance.traces.credentials.security_captcha",
    "quarter": "Q1",
    "financial_year": "FY 2024-25",
    "form": "24Q",
    "bsr_code": "<string>",
    "challan_date": 123,
    "challan_serial_no": "<string>",
    "provisional_receipt_number": "<string>",
    "challan_amount": 123,
    "unique_pan_amount_combination_for_challan": [
      [
        "<string>"
      ]
    ]
  },
  "remember_me": true
}
'

{
  "code": 200,
  "timestamp": 1716870600000,
  "transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.certificate.job",
    "job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
    "tan": "AHMA09719B",
    "quarter": "Q4",
    "financial_year": "FY 2023-24",
    "form": "24Q",
    "status": "created",
    "remember_me": false,
    "created_at": 1716870600000
  }
}

Headers

Authorization

string

required

JWT access token

x-api-key

string

required

API key for identification

x-api-version

string

Path Parameters

certificate_type

enum<string>

required

Available options:

form16,

form16a

Body

application/json

@entity

enum<string>

required

Available options:

in.co.sandbox.tds.compliance.traces.credentials

username

string

required

Username of the TRACES portal

password

string

required

The password of the TRACES portal

tan

string

required

security_captcha

object

required

Details required to generate TDS certificates

Show child attributes

security_captcha.@entity

enum<string>

Available options:

in.co.sandbox.tds.compliance.traces.credentials.security_captcha

security_captcha.quarter

enum<string>

Available options:

Q1,

Q2,

Q3,

Q4

security_captcha.financial_year

string

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

Example:

"FY 2024-25"

security_captcha.form

enum<string>

TDS return form

Available options:

24Q,

26Q,

27Q

security_captcha.bsr_code

string

Bank-Branch Code/ Form 24G Receipt Number

security_captcha.challan_date

integer

EPOCH timestamp of challan paid on date (in milliseconds)

security_captcha.challan_serial_no

string

Bank Challan Number. Priority in choosing challan : Challan with distinct 3 payments (PAN-amount combination) > Challan with distinct 2 payments > Challan with distinct 1 payment

security_captcha.provisional_receipt_number

string

Provisional regular return receipt number of recently filed return

security_captcha.challan_amount

integer

total amount of the challan

security_captcha.unique_pan_amount_combination_for_challan

string[][]

Three different PANs and total TDS deposited against them in the mentioned Challan

remember_me

boolean

required

Whether to remember the credentials

Response

200 - OK

code

integer

timestamp

integer

transaction_id

string

data

object

Show child attributes

data.@entity

string

data.job_id

string

data.tan

string

data.quarter

string

data.financial_year

string

data.form

string

data.status

string

data.remember_me

boolean

data.created_at

integer

Fetch Jobs

Remember Credentials Preference

⌘I

Calculator

Analytics

Reports

Compliance

Annexures

Headers

Path Parameters

Body

Response