Transactions

The transactions endpoint returns the transactions which have occurred for a specific entity. For each valueDate where transactions are received from a custodian, data will be available in the transactions endpoint once standardised through data processing layer. Requests are made using the entityId parameter, which is mandatory.

For the full list of parameters accepted as well as which are required, see Parameters below. To view Sample response data, expand the menu under Responses and refer to the Example tab. To see the format of the response fields, as well as which are mandatory (that is, always returned in the response), select the tab Schema, and then expand object followed by content and finally object once more.

Request and Response

You might find it helpful to access our Sesame Data Developer Portal

The format of all Sesame Custodial Data APIs is the same. The user is required to provide their account UUID and token in the authorisation, and then make a GET request to the transactions endpoint, specifying the entityId of the entity being requested.

GEThttps://data.api.landytech.net/api/v1/transactions/{entityId}

Path parameters

entityId*integer (int64)

Unique identifier provided by Landytech

Example: 123

Query parameters

Response

200

OK

Body

application/json

content*array of ExternalTransactionDto (object)

totalPages*integer (int64)

Number of pages

Example: 1

totalElements*integer (int64)

Number of elements across all pages

Example: 1

last*boolean

Last page

Example: true

size*integer (int64)

Number of elements in one page

Example: 100

first*boolean

First page

Example: true

number*integer (int64)

Current page number

Example: 0

numberOfElements*integer (int64)

Number of elements in the page

Example: 1

empty*boolean

Empty

Example: false

Request

JavaScriptCurl

const response = await fetch('https://data.api.landytech.net/api/v1/transactions/{entityId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "content": [
    {
      "entityId": 36403,
      "tradeDate": "2024-01-09",
      "settlementDate": "2024-01-11",
      "valueDate": "2022-10-04",
      "entityName": "HSBC (7095754)",
      "assetName": "PCSB Financial Ord Shs",
      "assetId": 118183,
      "isin": "US69324R1041",
      "transactionSubtype": "Purchase",
      "quantity": 10000,
      "localCurrency": "USD",
      "unitPrice": 18.05,
      "amount": -185362.45,
      "commissionsLc": -362.45,
      "transactionId": "187318436 USD 2024-01-09",
      "description": "Purchase - PCSB Financial Corp",
      "stampDutyLc": 0,
      "withholdingTaxLc": 0,
      "collectionChargeLc": 0,
      "taxLc": 0,
      "reversal": false,
      "subPortfolioCode": "7095754.001.01",
      "capitalOrIncome": "CAPITAL",
      "movementRc": -145907.13,
      "grossMovementLc": -185000,
      "grossMovementRc": -145621.83,
      "subPortfolioCode2": "7095754.002.01",
      "localCurrency2": "GBP",
      "accruedInterestLc": 0
    }
  ],
  "totalPages": 1,
  "totalElements": 1,
  "last": true,
  "size": 100,
  "first": true,
  "number": 0,
  "numberOfElements": 1,
  "empty": false
}

Supported Transaction Subtypes

Admin Fees, Borrowing, Brokerage Fees, Capital Call, Cash Acquisition, Commitment, Commitment Reduction, Custodian Fees, Deposits, Derivative Cash Settlement, Derivative Premium, Distribution, Dividend, Dividend in Kind, Dividend Received, Financing, Income Withdrawal, Initial Margin, Interest, Interest Expense, Internal FX Transaction, Issuance, Maintenance Margin, Management Fees, Other costs, Other Fees, Principal repayment, Purchase, Redemption, Reverse Stock Split, Rights Issue, Rights Issue Exercise, Sales, Security Issuance, Security Redemption, Security Transfer In, Security Transfer Out, Spin Off, Stock Acquisition, Stock Split, Subscription, Taxes, Variation Margin, Withdrawals