product features
Understand a user’s investments

Gain insight into a user’s investment accounts, including account balances, holdings, and transactions that create a change in a holding

Expansive institution coverage

Retrieve investment data from a broad coverage network that includes banks, brokerages, and pension providers

Full breadth of account types

Connect to the full breadth of UK investment account types—from brokerage accounts to pensions and ISAs

Retrieve Holdings response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "GB0005603997",
    "cusip": null,
    "sedol": "0560399",
    "proxy_security_id": null,
    "name": "Legal & General Group",
    "ticker_symbol": "LGEN",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 311.40,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  },{
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": "LU1781541096",
    "cusip": null,
    "sedol": "BFX0551",
    "proxy_security_id": null,
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "ticker_symbol": "LCUK",
    "is_cash_equivalent": false,
    "type": "etf",
    "close_price": 10.76,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }],
  "holdings": [{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cost_basis": 4.28,
    "quantity": 100,
    "institution_price": 311.40,
    "institution_price_as_of": "2020-02-13",
    "institution_value": 31140,
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  },{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cost_basis": 22.32,
    "quantity": 150.00,
    "institution_price": 10.76,
    "institution_price_as_of": "2020-02-13",
    "institution_value": 1614,
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }]
}

Retrieve Investment Holdings data

The /investments/holdings/get endpoint returns a detailed breakdown of an account’s holdings, including quantity, price, total value, ticker, and common name

cost_basis

Total cost of acquiring the holding—this is a summation of all purchases of the security, including fees

quantity

The count of the security purchased

institution_price

The price of the security, according to the institution

institution_value

The value of the holding, according to the institution

securities

Definitions for the securities referenced by these holdings, including standardised identifiers, trading symbols, and classifications

Retrieve Investment Holdings data

The /investments/holdings/get endpoint returns a detailed breakdown of an account’s holdings, including quantity, price, total value, ticker, and common name

Retrieve Holdings response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "GB0005603997",
    "cusip": null,
    "sedol": "0560399",
    "proxy_security_id": null,
    "name": "Legal & General Group",
    "ticker_symbol": "LGEN",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 311.40,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  },{
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": "LU1781541096",
    "cusip": null,
    "sedol": "BFX0551",
    "proxy_security_id": null,
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "ticker_symbol": "LCUK",
    "is_cash_equivalent": false,
    "type": "etf",
    "close_price": 10.76,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }],
  "holdings": [{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cost_basis": 4.28,
    "quantity": 100,
    "institution_price": 311.40,
    "institution_price_as_of": "2020-02-13",
    "institution_value": 31140,
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  },{
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cost_basis": 22.32,
    "quantity": 150.00,
    "institution_price": 10.76,
    "institution_price_as_of": "2020-02-13",
    "institution_value": 1614,
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }]
}

cost_basis

Total cost of acquiring the holding—this is a summation of all purchases of the security, including fees

quantity

The count of the security purchased

institution_price

The price of the security, according to the institution

institution_value

The value of the holding, according to the institution

securities

Definitions for the securities referenced by these holdings, including standardised identifiers, trading symbols, and classifications

Retrieve Investment Transactions data

The /investments/transactions/get endpoint returns details on transactions that create a change in one or more holdings in a portfolio, such as buys, sells, splits, or dividends. Cash transfers in and out of an investment account are also returned

name

Description of the transaction, taken from the institution

quantity

Amount of the security that is moved in the transaction

amount

The value of the transaction = price * quantity

price

The price of the security for this transaction

type

A broad transaction type that informs the treatment of the transaction

securities

Definitions for the securities referenced by these holdings, including standardised identifiers, trading symbols, and classifications

Retrieve Investment Transactions response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "GB0005603997",
    "cusip": null,
    "sedol": "0560399",
    "proxy_security_id": null,
    "name": "Legal & General Group",
    "ticker_symbol": "LGEN",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 311.40,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
   },{
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": "LU1781541096",
    "cusip": null,
    "sedol": "BFX0551",
    "proxy_security_id": null,
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "ticker_symbol": "LCUK",
    "is_cash_equivalent": false,
    "type": "etf",
    "close_price": 10.76,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }],
  "investment_transactions": [{
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "date": "2020-02-13",
    "name": "Dividend Lyxor Core Morningstar UK UCITS ETF",
    "quantity": 0.67,
    "amount": 0.67,
    "price": 1,
    "fees": 0,
    "type": "cash",
    "subtype": "dividend",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
    "date": "2020-02-12",
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "quantity": 10,
    "amount": 1053,
    "price": 10.53,
    "fees": 0,
    "type": "buy",
    "subtype": "contribution",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
    "date": "2020-02-13",
    "name": "Legal & General Group",
    "quantity": 25,
    "amount": 7804.75,
    "price": 312.19,
    "fees": 4.95,
    "type": "buy",
    "subtype": "buy",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }]
}

Retrieve Investment Transactions data

The /investments/transactions/get endpoint returns details on transactions that create a change in one or more holdings in a portfolio, such as buys, sells, splits, or dividends. Cash transfers in and out of an investment account are also returned

Retrieve Investment Transactions response

http code 200
{
  "accounts": [{object}],
  "securities": [{
    "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "isin": "GB0005603997",
    "cusip": null,
    "sedol": "0560399",
    "proxy_security_id": null,
    "name": "Legal & General Group",
    "ticker_symbol": "LGEN",
    "is_cash_equivalent": false,
    "type": "equity",
    "close_price": 311.40,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
   },{
    "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "isin": "LU1781541096",
    "cusip": null,
    "sedol": "BFX0551",
    "proxy_security_id": null,
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "ticker_symbol": "LCUK",
    "is_cash_equivalent": false,
    "type": "etf",
    "close_price": 10.76,
    "close_price_as_of": "2020-02-13",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }],
  "investment_transactions": [{
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "date": "2020-02-13",
    "name": "Dividend Lyxor Core Morningstar UK UCITS ETF",
    "quantity": 0.67,
    "amount": 0.67,
    "price": 1,
    "fees": 0,
    "type": "cash",
    "subtype": "dividend",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
    "date": "2020-02-12",
    "name": "Lyxor Core Morningstar UK UCITS ETF",
    "quantity": 10,
    "amount": 1053,
    "price": 10.53,
    "fees": 0,
    "type": "buy",
    "subtype": "contribution",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }, {
    "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
    "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
    "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
    "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
    "date": "2020-02-13",
    "name": "Legal & General Group",
    "quantity": 25,
    "amount": 7804.75,
    "price": 312.19,
    "fees": 4.95,
    "type": "buy",
    "subtype": "buy",
    "iso_currency_code": "GBP",
    "unofficial_currency_code": null
  }]
}

name

Description of the transaction, taken from the institution

quantity

Amount of the security that is moved in the transaction

amount

The value of the transaction = price * quantity

price

The price of the security for this transaction

type

A broad transaction type that informs the treatment of the transaction

securities

Definitions for the securities referenced by these holdings, including standardised identifiers, trading symbols, and classifications

Plaid enables our users to easily link their held-away investment accounts to our platform, and the /investments/holdings/get endpoint returns a detailed view of positions to support our in-depth analysis across a broad set of investment account types. Additionally, the Plaid team has been a joy to work with as we beta tested the product.
Andrew Moreland, founder and CTO of Haven