GetSessionsLiteByTransactionId

Use this call instead of GetSessionsByTransactionId and GetSessionsByTransactionIdMetadata. This call will eventually replace both of those calls.

Retrieves an array of SigningSession object(s) by an individual transaction Id, holding only some session header info in a paginated manner where the caller provides the page size, page number etc… The caller can control when to stop making the paginated call when it reaches the TotalCount value.

URI GET rest/v1/sessions/lite/{username}/{transactionId}/{pageSize}/{pageNum}/sortBy?colName={sortCol}&sortOrder={sortOrder}

Returns – A ResponseSessionInfoLiteView containing an array of Session Object(s).  (See ResponseSessionInfoLiteView in Appendix B)

Parameters

Name Type Description
encryptedToken string Required. Encrypted Token returned from client authentication.
Returns null if token has expired or is invalid.
transactionId string Required. Clients’ system transaction id for the transaction
username string Required. User’s username, their email address.
sortCol string Required. The name of the column to sort on must be one of these (SigningSessionId, Title, TransactionId, StatusCode, CreatedOn).
sortOrder string Required. The desired sort order, either (asc or desc).
pageSize int Required. How many records do you want on a page. Maximum value is 50
pageNum int Required. The page number (0-based) the client is on up to the returned totalCount. i.e if total totalCount is 10, then the sequence of pageNum would be 0, 1, 2…9

Example – C#
[gdlr_notification icon=”none” type=”color-border” border=”#31BEF9″ color=”#000000″]
string uri = “rest/v1/sessions/lite/{0}/{1}/{2}/{3}/sortBy?colName={3}&sortOrder={5}”;
string responseString = string.Empty;
JavaScriptSerializer jss = new JavaScriptSerializer();
ResponseSessionInfoLiteView sessionResponse;

var pageSize = 50; // Max value
var pageNum = 0; // 0-based from 0 to (totalCount – 1)
var sortCol = “Title”;

uri = string.Format(uri, username, “Transaction Id”, pageSize, pageNum, sortCol, “asc”);
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host + uri);
request.Headers.Add(“Authorization” , encryptedToken);
request.Method = “GET”;
request.ContentType = “application/json”;

HttpWebResponse response = (HttpWebResponse)request.GetResponse();
responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
sessionResponse = jss.Deserialize<ResponseSessionInfoLiteView>(responseString);

[/gdlr_notification]