Skip to main content
POST
Before you search TDS challans, add the TRACES credentials for the TAN. If the credentials already exist, you do not need to add them again.
To look up a challan with its payment details, use Fetch TDS challan details. 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

Deposit-date filters for a deductor's challan search. Both dates are required. Pagination is optional.

@entity
enum<string>
default:in.co.sandbox.tds.compliance.challan.search
required

Identifies the type of this object.

Available options:
in.co.sandbox.tds.compliance.challan.search
tan
string
required

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

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

Start of the deposit-date range in epoch milliseconds, interpreted in Asia/Kolkata.

Required range: x >= 0
to_date_epoch
integer
required

End of the deposit-date range in epoch milliseconds, interpreted in Asia/Kolkata.

Required range: x >= 0
id
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.

page_number
integer

Zero-based page number. 0 requests the first page. Omit to use the default page.

Required range: x >= 0
page_size
integer

Number of challans requested per page. Omit to use the default page size.

Required range: x >= 1

Response

One page of challans with pagination totals. The data list is empty when the page contains no challans.

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
ChallanSearchResponse · object
required

One page of challans with pagination totals reported by TRACES.