GTD ORDER HISTORY

This API retrieves the history of GTD (Good Till Date) orders for authorized end users through a middleware-based integration.

The API provides detailed information about GTD orders, including order status changes, traded quantities, pending quantities, and exchange order details.

🔑 Header Parameters

Fields	Type	Required	Description	Example
Authorization	string	Yes	Bearer token for authentication	access_token
x-api-key	string	Yes	API key provided	x-api-key

🔍 Query Parameters

Fields	Type	Required	Description	Example
userId	string	Yes	User ID (UCC)	{{user_id}}
offset	integer	No	Specifies the page number of the collection to be displayed	1
limit	integer	No	Limits the number of items returned per page	1000
gtdOrderId	string	No	GTD Order ID used to filter records. Must be URL encoded if it contains special characters	20230123NXVZO0000000

🟢 Success Response - 200 OK

Fields	Type	Description	Example
status	string	Status of API call	"success"
code	string	Response code	"s-101"
message	string	Success message	"GTD Order History fetched successfully"
data	array(object)	GTD Order history records	See below table

📘 GTD Order History Object Fields

Fields	Type	Description	Example
order_date	string	Date on which the GTD order was created or updated	"2026-07-02"
gtd_order_id	string	System-generated GTD Order ID	"20230123NXVZO0000000"
exchange_order_no	string	Exchange order number	"120000000123456"
client_order_no	number	Client order number	1012456
exchange	string	Exchange segment	"NSE_EQ"
symbol	string	Trading symbol	"INFY"
series	string	Series	"EQ"
transaction_type	string	Buy or Sell transaction	"BUY"
total_quantity	number	Original order quantity	100
order_price	string	Order price	"2500.50"
status	string	Current order status	"OPEN"
pending_quantity	number	Pending quantity	50
traded_quantity	number	Cumulative traded quantity	50
previous_traded_quantity	number	Previously traded quantity before the latest update	25