GET
/
links
/
{id}
/
investments
/
transactions
/links/{id}/investments/transactions
curl --request GET \
  --url http://localhost:8080/links/{id}/investments/transactions \
  --header 'Authorization: Bearer <token>'
{
  "total": 82,
  "page": 1,
  "size": 50,
  "transactions": [
    {
      "invtransaction_id": "it_R73abx78zoa2NxyAlki90g",
      "account_id": "acc_6Tef269B6ZArSVpYrxtjBV",
      "amount": 987.15,
      "date": "2023-02-16T00:00:00",
      "datetime": "2023-02-16T09:14:11",
      "description": "Bought MSFT",
      "type": "buy",
      "fees": 5.95,
      "forex_rate": "<string>",
      "price": 98.12,
      "quantity": 10,
      "security_id": "sec_bb6fi893jxdfNxyAjnb784"
    }
  ],
  "securities": [
    {
      "security_id": "sec_bb6fi893jxdfNxyAjnb784",
      "name": "Microsoft",
      "type": "equity",
      "currency": "USD",
      "ticker": "MSFT",
      "isin": "US5949181045",
      "sedol": "<string>",
      "close_price": 98.12,
      "close_datetime": "2023-02-16T09:14:11"
    }
  ],
  "accounts": [
    {
      "account_id": "acc_6Tef269B6ZArSVpYrxtjBV",
      "account_type": "depository.checking",
      "name": "Premier Checking",
      "account_mask": "3748",
      "balances": {
        "currency": "USD",
        "available": 340.12,
        "current": 445.89,
        "limit": 500
      }
    }
  ],
  "link": {
    "link_id": "mk_eqkWN34UEoa2NxyALG8pcV",
    "institution_id": "chase",
    "institution_name": "Chase",
    "provider": "mx",
    "state": "connected",
    "last_synced_at": "2023-02-16T09:14:11",
    "tags": [
      "user_type:admin"
    ],
    "products": {
      "accounts": {
        "refreshed_at": "2023-02-16T09:14:11",
        "last_attempted_at": "2023-02-16T09:14:11"
      },
      "identity": {
        "refreshed_at": "2023-02-16T09:14:11",
        "last_attempted_at": "2023-02-16T09:14:11",
        "settings": {
          "required": true,
          "prefetch": false
        }
      }
    }
  }
}
Results are paginated, and returned in reverse chronological order.
Note that this endpoint does not trigger a fetch of transactions from the institution; it merely returns transactions that have already been fetched.
To force a check for new/updated owner information, you must use the products endpoint.
If you have requested prefetch or an on-demand update, you should check the refreshed_at date for this product in the returned response and compare that against the previous refreshed_at date, which you can get from any previous response for this or any other account or link request. If the refreshed_at date has not increased, then updated data is not yet available.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
moneykit-version
string
default:2023-02-18

Path Parameters

​
id
string
required

The unique ID for this link.

Query Parameters

​
account_ids
string[]

An optional list of account IDs to filter the results.

​
page
integer
default:1

The page number to return.

Required range: x >= 1
​
size
integer
default:50

The number of items to return per page.

Required range: 1 <= x <= 100
​
start_date
string

The earliest date for which data should be returned, formatted as YYYY-MM-DD. Defaults to 90 days before the end_date. <p>If you want to retrieve all transactions, use 1900-01-01.

​
end_date
string

The latest date for which data should be returned, formatted as YYYY-MM-DD. Defaults to today.

Response

200
application/json

Successful Response

The response is of type object.