Skip to main content
GET
Get bulk PAN verification status
Pass the TRACES token_number as a query parameter and deductor_access_token in the Authorization header. This request has no body. While the report is unavailable, data contains token_number, the TRACES status array, and rejection_remarks. Status values and rejection remarks retain the source text. When the report is available, data contains only output_json_url. Download the PAN verification workbook from this signed URL within 24 hours. Generated files are retained for 30 days. If the deductor access token expires, refresh the deductor session, then retry this request with the new access token.

Headers

Authorization
string
required

Deductor access token returned by Authenticate a TRACES deductor. The token identifies the deductor TAN.

x-api-key
string
required

Sandbox API key.

Content-Type
string
required

Request body format.

Query Parameters

token_number
string
required

Token number returned when the PAN verification request was submitted.

Response

The TRACES status history or the signed URL for the completed PAN verification workbook.

code
enum<integer>
required
Available options:
200
timestamp
integer
required

Unix timestamp in milliseconds.

transaction_id
string
required
data
object
required