Skip to main content
POST
Save the TRACES credentials for the TAN in your Sandbox workspace. Sandbox manages TRACES authentication during processing. After creating the job, upload the JSON payee workbook to data.json_url with HTTP PUT. Then use data.job_id to check the job status.
Credential checks happen after the workbook upload. Missing or incorrect TRACES credentials appear as a failed job with a message in the status response.
For cURL examples covering the complete workflow, see Verify PANs in bulk.

Headers

Authorization
string
required

Sandbox JWT access token. See the Quickstart guide.

x-api-key
string
required

Sandbox API key for the request.

Content-Type
string
required

Request body format.

Body

application/json

Creates a bulk PAN verification job for a TAN. The payee workbook is uploaded separately to the returned signed URL.

@entity
enum<string>
required

Request entity type.

Available options:
in.co.sandbox.tds.compliance.pan.verification.request
tan
string
required

Tax Deduction and Collection Account Number associated with the saved TRACES credentials.

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

"AHMA12345A"

Response

The job is created and ready for the input workbook upload.

code
enum<integer>
required

HTTP status code.

Available options:
200
timestamp
integer<int64>
required

Response timestamp in epoch milliseconds.

transaction_id
string<uuid>
required

Unique identifier for this API transaction.

data
object
required

A bulk PAN verification job. Upload the input through json_url. A succeeded job provides output_json_url. A failed job provides message.