We're sorry but

Your browser is not supported.

To enjoy our website, try using
a newer browser like Google Chrome,
Mozilla Firefox, or Microsoft Edge.

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, credit unions, and retirement plan providers

Full breadth of account types

Connect to the full breadth of investment account types—from brokerage and retirement accounts, to 529s and HSAs

Multiple endpoints for
many use cases

With multiple endpoints, Investments can enable a wide range of use cases—from net worth assessment and financial planning, to performance reporting and risk optimization

Retrieve Holdings response

                        
                          
      http code 200
      {
        "accounts": [{object}],
        "securities": [{
          "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "isin": "US85207UAE55",
          "cusip": "85207UAE5",
          "sedol": null,
          "institution_security_id": null,
          "institution_id": "ins_102937",
          "proxy_security_id": null,
          "name": "Sprint Corporation",
          "ticker_symbol": "S",
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 6.10,
          "close_price_as_of": "2019-04-16",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }{
          "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "isin": null,
          "cusip": null,
          "sedol": null,
          "institution_security_id": "VGSLX",
          "institution_id": "ins_115616",
          "proxy_security_id": null,
          "name": "Vanguard Real Estate Index",
          "ticker_symbol": null,
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 26.44,
          "close_price_as_of": "2019-04-15",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }],
        "holdings": [{
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "cost_basis": 4.28,
          "quantity": 2104.07,
          "institution_price": 6.09,
          "institution_price_as_of": "2019-04-19",
          "institution_value": 12813.79,
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        },{
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cost_basis": 22.32,
          "quantity": 150.00,
          "institution_price": 26.44,
          "institution_price_as_of": "2019-04-19",
          "institution_value": 3348,
          "iso_currency_code": "USD",
          "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 standardized identifiers, trading symbols, and classifications

View API docs

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": "US85207UAE55",
          "cusip": "85207UAE5",
          "sedol": null,
          "institution_security_id": null,
          "institution_id": "ins_102937",
          "proxy_security_id": null,
          "name": "Sprint Corporation",
          "ticker_symbol": "S",
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 6.10,
          "close_price_as_of": "2019-04-16",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }{
          "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "isin": null,
          "cusip": null,
          "sedol": null,
          "institution_security_id": "VGSLX",
          "institution_id": "ins_115616",
          "proxy_security_id": null,
          "name": "Vanguard Real Estate Index",
          "ticker_symbol": null,
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 26.44,
          "close_price_as_of": "2019-04-15",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }],
        "holdings": [{
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "cost_basis": 4.28,
          "quantity": 2104.07,
          "institution_price": 6.09,
          "institution_price_as_of": "2019-04-19",
          "institution_value": 12813.79,
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        },{
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cost_basis": 22.32,
          "quantity": 150.00,
          "institution_price": 26.44,
          "institution_price_as_of": "2019-04-19",
          "institution_value": 3348,
          "iso_currency_code": "USD",
          "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 standardized 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 standardized identifiers, trading symbols, and classifications

View API docs

Retrieve Investment Transactions response

                        
                          
      http code 200
      {
        "accounts": [{object}],
        "securities": [{
          "id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "isin": "US85207UAE55",
          "cusip": "85207UAE5",
          "sedol": null,
          "institution_security_id": null,
          "institution_id": "ins_102937",
          "proxy_security_id": null,
          "name": "Sprint Corporation",
          "ticker_symbol": "S",
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 6.10,
          "close_price_as_of": "2019-04-16",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
         }{
          "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "isin": null,
          "cusip": null,
          "sedol": null,
          "institution_security_id": "VGSLX",
          "institution_id": "ins_115616",
          "proxy_security_id": null,
          "name": "Vanguard Real Estate Index",
          "ticker_symbol": null,
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 26.44,
          "close_price_as_of": "2019-04-15",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }],
        "investment_transactions": [{
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "date": "2019-01-12",
          "name": "Dividend VANGUARD FEDERAL MONEY MARKET FUND (Settlement Fund)",
          "quantity": 0.84,
          "amount": 0.84,
          "price": 1,
          "fees": 0,
          "type": "cash",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }, {
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
          "date": "2018-12-18",
          "name": "VANGUARD WINDSOR INVESTOR CL",
          "quantity": 146.915,
          "amount": 3000,
          "price": 20.42,
          "fees": 0,
          "type": "buy",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }, {
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
          "date": "2018-10-30",
          "name": "SPRINT CORPORATION",
          "quantity": 372,
          "amount": 2118.91,
          "price": 5.68,
          "fees": 5.95,
          "type": "buy",
          "iso_currency_code": "USD",
          "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": "US85207UAE55",
          "cusip": "85207UAE5",
          "sedol": null,
          "institution_security_id": null,
          "institution_id": "ins_102937",
          "proxy_security_id": null,
          "name": "Sprint Corporation",
          "ticker_symbol": "S",
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 6.10,
          "close_price_as_of": "2019-04-16",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
         }{
          "id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "isin": null,
          "cusip": null,
          "sedol": null,
          "institution_security_id": "VGSLX",
          "institution_id": "ins_115616",
          "proxy_security_id": null,
          "name": "Vanguard Real Estate Index",
          "ticker_symbol": null,
          "is_cash_equivalent": false,
          "type": "mutual fund",
          "close_price": 26.44,
          "close_price_as_of": "2019-04-15",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }],
        "investment_transactions": [{
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9hhs",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "date": "2019-01-12",
          "name": "Dividend VANGUARD FEDERAL MONEY MARKET FUND (Settlement Fund)",
          "quantity": 0.84,
          "amount": 0.84,
          "price": 1,
          "fees": 0,
          "type": "cash",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }, {
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcY9asd",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0A1w5X",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr3I0D1o3Q",
          "date": "2018-12-18",
          "name": "VANGUARD WINDSOR INVESTOR CL",
          "quantity": 146.915,
          "amount": 3000,
          "price": 20.42,
          "fees": 0,
          "type": "buy",
          "iso_currency_code": "USD",
          "unofficial_currency_code": null
        }, {
          "investment_transaction_id": "VaYBeiw3H9AhAHw53vQYkmkn2s2qJOGcH2xvv",
          "account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
          "security_id": "EogDe9DwpZHd9YoYLbgdF0rowxo9XaIdxP9Y5",
          "cancel_transaction_id": "yNLYVbYWyAuzVnOnV6aOh0Qz1nzOr1X8B2w5X",
          "date": "2018-10-30",
          "name": "SPRINT CORPORATION",
          "quantity": 372,
          "amount": 2118.91,
          "price": 5.68,
          "fees": 5.95,
          "type": "buy",
          "iso_currency_code": "USD",
          "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 standardized 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