Depending on applicable regulations or business limitations, specific API requests may not be available for your use.
Get Folio Transactions
This request returns a summary of transactions for a folio within a member’s brokerage account.
Request URL
Syntax |
GET /restapi/accounts/{accountnumber}/folios/{folionumber}/transactions |
Example URL |
https://api.uat.foliofn.com/restapi/accounts/RA1234ABCD/folios/RA1234ABCD03/transactions?dateRange=1m&ticker=AMZN,APPL&category=Deposits&subcategory=CASH&cashsweep=N |
Request Query Parameters
Parameter |
Required? |
Description |
daterange |
N |
Default to 3 days. It can be a date range. The format of a date should be “MM-dd-yyyy”. The start date and the end date should be separated by a comma, (“,”). For example, “daterange=11-01-2013,09-01-2014 ”. In additional to a customdate range, the value of daterange parameter could also be a code. See the other valid codes in Date Range Codes table below. |
category |
N |
Transaction category name. See Transaction Codes |
subCategoryName |
N |
Transaction sub category name. See Transaction Codes |
ticker |
N |
Ticker symbol. You can pass mutiple tickers as comma delimited string, for example ticker="AMZN,AAPL,FB" |
cashsweep |
N |
Default to 'Y'. Indicator for showing cash sweep transactions or not. 'Y' means show. 'N' means not show. |
Response Data Fields
Field |
Values |
Description |
accountId |
|
Account identifier for Folio transaction occurred in |
categoryName |
see Transaction Codes
|
Transaction category name |
commission |
|
Trade commission |
date |
|
Date in ISO-8601 format |
folioName |
|
Name of folio |
marketNet |
|
Used for internal transfers, same value as 'net' |
marketPrice |
|
Used for internal transfers, same value as 'price' |
net |
|
Net dollar value |
notes |
|
Additional notes on transaction (If applicable) |
price |
|
Price per share |
quantity |
|
Quantity of shares |
subCategoryName |
see Transaction Codes
|
Sub category of the transaction categoryName |
symbolName |
|
Name of security |
ticker |
|
Ticker |
transactionCode |
see Transaction Codes
|
Folio transaction code |
transactionDesc |
see Transaction Codes |
Description of transaction |
transactionId |
|
Transaction identifier |
transactionType |
see Transaction Codes |
Additional information on type of transaction |
Date Range Codes
Code |
Description |
3d |
Three days |
5d |
Five days |
10d |
Ten days |
30d |
Thirty days |
1m |
One month |
3m |
Three months |
6m |
Six months |
12m |
Twelve months |
1y |
One year |
3y |
Three years |
5y |
Five years |
Mtd |
Month to date |
Ytd |
Year to date |
Category and Sub-category names
Please reference Get Account Transactions Transaction Codes
Response Example
HTTP/1.1 200 OK
Date: Thu, 14 Mar 2019 17:53:15 GMT
Transfer-Encoding: chunked
Location: https:// testapi api . uat. foliofn.com/restapi/accounts/RB18938005/folios/RB189380052W/transactions
Content-Type: application/json
[
{
"accountId" : "2445361",
"categoryName" : "Distributions",
"commission" : "0.00000",
"date" : "2016-01-08T00:00:00.000-05:00",
"folioName" : "Mid/Large Cap Blend",
"marketNet" : "0.00000",
"marketPrice" : "0.00000",
"net" : "0.36000",
"notes" : "",
"price" : "0.00000",
"quantity" : "0.77285",
"subCategoryName" : "Dividends",
"symbolName" : "MERCK & CO INC",
"ticker" : "MRK",
"transactionCode" : "CDIR",
"transactionDesc" : "Cash Dividend Receipt",
"transactionId" : "108",
"transactionType" : "Dividend"
}
]
Change Log
03/14/2019
- Update Response Data Fields
- Update Response Example
03/24/2017
- Update Response Data Fields
- Update Date Range Codes
- Update Response Example
- Added Category and Sub-category names
11/03/2016
- Added additional query paramenters
08/19/2016
- Updated Response Data Fields
02/01/2016
- Updated descriptions