Overview
Retrieve the details of a transaction.
Description

This API returns the details of a transaction, based on two required inputs - account ID and transaction ID. Both of these inputs are typically obtained by using the Get Transaction History API.

The same account types and transaction types are supported in both APIs. The details that are returned depend upon the type of transaction, e.g., a stock trade has a displaySymbol but a check transaction does not.

URL
https://etws.etrade.com/accounts/rest/{accountId}/transactions/{transactionId}
HTTP Method: GET
Request Parameters
Parameter Type Required? Description
accountId path required Numeric account ID
transactionId path required Numeric transaction ID, usually acquired by using the Get Transaction History API.
Sample Request
https://etws.etrade.com/accounts/rest/{accountId}/transactions/345678
Response Properties
Property Type Description
transactionDate long Date of the specified transaction
transactionType string Type of transaction (deposit, dividend, etc.). Possible values are listed in the Transaction types table below.
userDescription string User-defined description
transactionDescription string Transaction description
quantity decimal Item count (e.g., share count)
amount decimal Total cost of transaction, including commission if any
commission decimal Commission amount
price decimal Price per item if applicable (e.g., price per share)
productID complex Container for identity of the product
symbol string Security symbol in internal E*TRADE database format
typeCode string The type of security. Possible values are: EQ (equity), INDX (index), MF (mutual fund), FI (fixed income).
category string User-defined category
displaySymbol string Product symbol in client-facing display format , e.g., "GOOG" or "GOOG Dec 17 2012 $600.50 CALL"
underlyingProductId complex Container for identity of the underlier (if applicable)
symbol string Market symbol of the underlier, e.g., GOOG
typeCode string The type of security for the underlier. Possible values are: EQ (equity), INDX (index), MF (mutual fund), FI (fixed income).
settlementDate long Settlement date in epoch time
settlementCurrency string Settlement currency
paymentCurrency string Payment currency
accountOrderNo long Order number
Transaction types
Most transaction types are members of groups: trades (T), deposits (D), and withdrawals (W), as shown in the table below. Exceptions are corporate actions, currency exchange transactions, and sweep deposits. (This is the same table shown under Get Transaction History.)
Type Group Description
assignment T A balance adjustment as the result of another party exercising an option. For a definition of assignments, refer to the E*TRADE online glossary.
atm D, W Service charge from automated teller machines
check D, W Check deposit or withdrawal
corporate_actions   Split, merger, or acquisition
contribution D, W Money put into retirement fund
currency_xch   Currency exchange
debit W List of transactions that decrease assets
deposit D List of transactions that Increase assets
direct_debit W Decrease of assets
direct_deposit D Increase of assets
distribution D, W Money taken out of retirement fund
dividend D Dividend paid
exercise T A balance adjustment as the result of exercising an option
expiration T The date on which an option, right, or warrant expires and becomes worthless if not exercised. Also, the date on which an agreement is no longer in effect.
fee W Service fees
interest D Interest charged
pos D, W Point of sale debit
sweep   Sweep deposit
transfer D, W Cash transfer (in or out)
wire D, W Cash wire (in or out)
Sample Response - XML
<transactionDetails>
  <transactionDate>1266518024</transactionDate>
  <transactionType>bought</transactionType>
  <userDescription>reimbursement</userDescription>
  <transactionDescription>Bought 10 AAPL @200</transactionDescription>
  <quantity>10</quantity>
  <amount>2010.00</amount>
  <price>200.00</price>
  <commission>10.00</commission>
  <productId>
    <symbol>AAPL</symbol>
    <typeCode>EQ</typeCode>
  </productId>
  <underlyingProductId/>
  <displaySymbol>AAPL</displaySymbol>
  <accountOrderNo>10</accountOrderNo>
  <settlementCurrency>USD</settlementCurrency>
  <paymentCurrency>USD</paymentCurrency>
  <category></category>
  <settlementDate>1322456400</settlementDate>
</transactionDetails>
Sample Response - JSON
{
  "json.transactionDetails":{
    "transactionDate":1266518024,
    "transactionType":"bought",
    "userDescription":"reimbursement",
    "transactionDescription":"Bought 10 AAPL @200",
    "quantity":10,
    "amount":"2010.00",
    "price":"200.00",
    "commission":"10.00",
    "productId":{
      "symbol":"AAPL",
      "typeCode":"EQ"
    },
    "underlyingProductId":"",
    "displaySymbol":"AAPL",
    "accountOrderNo":10,
    "settlementCurrency":"USD",
    "paymentCurrency":"USD",
    "category":"",
    "settlementDate":1322456400
  }
}
Sample use cases
Some possible use cases and workflows are described below.
Purpose Workflow Related APIs
Transaction detail display User selects a transaction from a list of transactions that meet specified criteria (e.g., account, date range, symbol, transaction type). The details of the transaction are displayed along with supporting information such as basic account information and a description of any securities involved. Get Transaction History, Get Transaction Details, List Accounts, Look Up Product
Sandbox Samples
Request
https://etwssandbox.etrade.com/accounts/sandbox/rest/83405188/transactions/345678
Response
<transactionDetails>
  <transactionDate>1266518024</transactionDate>
  <transactionType>bought</transactionType>
  <userDescription>reimbursement</userDescription>
  <transactionDescription>Bought 10 AAPL @200</transactionDescription>
  <quantity>10</quantity>
  <amount>2010.00</amount>
  <price>200.00</price>
  <commission>10.00</commission>
  <productId>
    <symbol>AAPL</symbol>
    <typeCode>EQ</typeCode>
  </productId>
  <underlyingProductId/>
  <displaySymbol>AAPL</displaySymbol>
  <accountOrderNo>10</accountOrderNo>
  <settlementCurrency>USD</settlementCurrency>
  <paymentCurrency>USD</paymentCurrency>
  <category></category>
  <settlementDate>1322456400</settlementDate>
</transactionDetails>
Related APIs
PLEASE READ THE IMPORTANT DISCLOSURES BELOW

By using E*TRADE API ("API") and accepting the terms of the Application Programming Interface License Agreement and the Application Programming Interface User Agreement, you agree that API may employ security policies, procedures and systems of Third Party providers which may or may not be less stringent and secure than the policies, procedures and systems of E*TRADE Securities LLC ("E*TRADE") or its affiliates. Material provided on API may have been produced by independent third parties not affiliated or endorsed by E*TRADE or its affiliates ("Third Party"). To the extent that API or Third Party providers express opinions or make recommendations, you understand that such opinions or recommendations are expressed by the Third Party provider and are not the opinions or recommendations of E*TRADE or its affiliates. E*TRADE is not responsible for the accuracy of market data displayed on API or made available by Third Party providers. There may be latency between the time an order (or other information) is submitted from API and the time the order is received by E*TRADE. The E*TRADE Two Second Execution Guarantee or any similar guarantee does not apply for orders placed through API and Third Party provider web sites. The E*TRADE CompleteTM Protection Guarantee does not apply. Orders created and submitted through API are not vetted until they are received by E*TRADE. It is possible that E*TRADE may reject an order placed through API. Please see the Application Programming Interface License Agreement and the Application Programming Interface User Agreement for more information.


The E*TRADE family of companies provides financial services including trading, investing, and related banking products and services to retail investors.


Securities products and services offered by E*TRADE Securities LLC, Member FINRA/SIPC.


System response and account access times may vary due to a variety of factors, including trading volumes, market conditions, system performance, and other factors.