Authenticate TRACES session

Overview

  • The API enables you to authenticate to the TRACES portal

Problem

  • Manually downloading large volumes of files like millions of Form 16 and Forms 16A becomes a tedious and time-consuming process

Solution

  • This API takes the respective nature_of_payment under TDS requirements and provides applicable TDS liability
  • Automating the consent-based retrieval of Form 16 and Form 16A

Endpoint

HTTP MethodEndpoint
POSTtds-compliance/traces/authenticate

API EndpointAPI Endpoint

Request

Body

A Request Body (JSON) is uploaded for authenticating your TRACES session

ParametersRequiredTypeDescriptionExample
user_idYesstringUsername of the TRACES portalusername
passwordYesstringThe password of the TRACES portalpassword
tanYesstringTax Deduction Account Number (TAN)AHMQ21432A

Once the values are added, Your curl will look something like this

curl --request POST \
     --url https://api.sandbox.co.in/tds-compliance/traces/authenticate \
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxx' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
    "user_id": "username",
    "password": "password",
    "tan": "AHMQ21432A"
}
'

🚧

Test Data Not Available

Instead, input valid credentials along with live_key to use the API.


Response

ParamTypeDescription
access_tokenstringJWT Authorization token generated for TRACES session