RECOMMENDATIONS

This API retrieves broker-generated trading recommendations and investment ideas based on the categories available to the user.

🔗 Path Parameters

Parameter	Type	Required	Description	Example
tenantid	string	Yes	Unique id provided for the tenant by SIPL	"tenant001"

🔍 Query Parameters

Parameter	Type	Required	Description	Example
userId	string	Yes	User ID (UCC)	"{{user_id}}"
allowedNewsCat	string	No	Comma-separated list of allowed recommendation/news categories	"25014,25033,25000,25035,25034,25039"
pageNo	integer	No	Page number for pagination	1
pageSize	integer	No	Number of records per page	10

🔑 Header Parameters

Header	Type	Description	Example
Content-Type	string	Request payload format	application/json
Authorization	string	Access token for authenticated requests	{{access_token}}
x-api-key	string	API key used to authorize request	{{x-api-key}}

🟢 Success Response - 200 OK

Content-Type: application/json

Field	Type	Description
status	boolean	Status of API call
result	array	List of broker recommendations

📦 Recommendation Fields

Field	Type	Description	Example
sRecoTag	string	Free-text tag assigned to the recommendation	"Short Term Buy"
sRecoId	string	Unique recommendation identifier	"REC12345"
sScripDesc	string	Scrip description	"INFOSYS LTD"
nMarketSegmentId	integer	Market Segment ID	1
nToken	integer	Exchange token number of the scrip	1594
nRecoType	integer	Recommendation type	1 = Buy, 2 = Sell
sRecoDetails	string	Recommendation details — an XML string embedded inside this text field	See note below
sSource	integer	Recommendation source identifier	1
ID	string	Record ID	"98765"
LastModify	string	Last modified date/time	"2022-04-02T00:26:17.390Z"
nTotalNoRecords	integer	Total number of available recommendation records	125
nExpiryDate	string	Recommendation expiry date	"2022-04-02T23:59:00.000Z"

📝 Notes

• sRecoDetails requires XML parsing to extract structured recommendation data (entry price, stop-loss, square-off targets).
• Timestamps (LastModify, nExpiryDate) are in UTC — convert to local time as needed for display.