Fetch TDS challan details

curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/traces/deductors/challans \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.challan.request",
  "tan": "AHMA12345A",
  "bsr_code": "0123456",
  "challan_serial": "00042",
  "paid_date_epoch": 1784053800000
}
'

{
  "code": 200,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.challan.response",
    "tan": "AHMA12345A",
    "bsr_code": "0123456",
    "challan_serial": "00042",
    "paid_date_epoch": 1784053800000,
    "challan_identification_number": "01234561507202600042",
    "receipt_number": "9000000001",
    "financial_year": "FY 2026-27",
    "major_head": "0021",
    "minor_head": "200",
    "total_amount": 1500,
    "status": "CLAIMED",
    "section_code": "94D",
    "residency_status": "R",
    "tax_breakdown": [
      {
        "@entity": "in.co.sandbox.tds.compliance.challan.tax_breakdown",
        "section": "393(1) [Table: Sl. No. 1(i)]",
        "tax_amount": 1500,
        "surcharge": 0,
        "cess": 0,
        "total_amount": 1500
      }
    ],
    "consumption_details": null
  }
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 401,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Invalid credentials"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 500,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Failed to log in to TRACES"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 521,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Credentials not found"
}

POST

tds

compliance

traces

deductors

challans

curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/traces/deductors/challans \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.challan.request",
  "tan": "AHMA12345A",
  "bsr_code": "0123456",
  "challan_serial": "00042",
  "paid_date_epoch": 1784053800000
}
'

{
  "code": 200,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.challan.response",
    "tan": "AHMA12345A",
    "bsr_code": "0123456",
    "challan_serial": "00042",
    "paid_date_epoch": 1784053800000,
    "challan_identification_number": "01234561507202600042",
    "receipt_number": "9000000001",
    "financial_year": "FY 2026-27",
    "major_head": "0021",
    "minor_head": "200",
    "total_amount": 1500,
    "status": "CLAIMED",
    "section_code": "94D",
    "residency_status": "R",
    "tax_breakdown": [
      {
        "@entity": "in.co.sandbox.tds.compliance.challan.tax_breakdown",
        "section": "393(1) [Table: Sl. No. 1(i)]",
        "tax_amount": 1500,
        "surcharge": 0,
        "cess": 0,
        "total_amount": 1500
      }
    ],
    "consumption_details": null
  }
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 401,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Invalid credentials"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 500,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Failed to log in to TRACES"
}

{
  "code": 123,
  "timestamp": 123,
  "transaction_id": "<string>",
  "message": "<string>"
}

{
  "code": 521,
  "timestamp": 1791829800000,
  "transaction_id": "87c1b4f6-1632-4d8b-a2f9-05f291c00a42",
  "message": "Credentials not found"
}

Before you fetch TDS challan details, add the TRACES credentials for the TAN. If the credentials already exist, you do not need to add them again.

To find challans by deposit date, use Search TDS challans. See Check TDS challans for credential setup and cURL examples.

Headers

Authorization

string

required

JWT access token. For token-generation steps, refer to the Quickstart Guide.

x-api-key

string

required

API key used to identify and authenticate the client.

Content-Type

string

required

Request body format.

Body

application/json

Particulars that identify a TDS challan for a deductor.

@entity

enum<string>

default:in.co.sandbox.tds.compliance.challan.request

required

Identifies the type of this object.

Available options:

in.co.sandbox.tds.compliance.challan.request

tan

string

required

Tax Deduction and Collection Account Number (TAN) of the deductor.

Pattern: ^[A-Z]{4}[0-9]{5}[A-Z]$

bsr_code

string

required

Basic Statistical Return (BSR) code of the bank branch where the challan was deposited.

Pattern: ^[0-9]{7}$

challan_serial

string

required

Five-digit challan serial number, including leading zeroes.

Pattern: ^[0-9]{5}$

paid_date_epoch

integer

required

Deposit date in epoch milliseconds. The calendar date is interpreted in Asia/Kolkata.

Required range: x >= 0

string

Object identifier, when available.

description

string

Additional information about the object, when available.

created_at

string

Creation timestamp, when available.

updated_at

string

Last update timestamp, when available.

Response

The matching challan with its tax and available consumption details.

code

integer

required

HTTP status code.

timestamp

integer

required

Response timestamp in epoch milliseconds.

transaction_id

string

required

Unique identifier for this API request.

data

Challan · object

required

A TDS challan with its tax breakdown and available utilization details from TRACES. All amounts are in INR.

Show child attributes

Calculator

Analytics

Reports

Compliance

Annexures

Fetch TDS challan details

Headers

Body

Response