API changelog

Track changes to the Plaid API

This changelog tracks all updates to the API. Prior to September 2020, some minor updates may not appear in the changelog. For backwards-incompatible, versioned changes, see API Versions.

This changelog tracks only changes to the API. For changes to Link SDKs or to client libraries, see the GitHub changelog for the relevant SDK or library.

December 2020
  • Made Bank Transfers (beta) available for testing in the Development environment.
  • Added investments_updates to the status object returned by Institutions endpoints.
November 2020
  • Removed some internal-only, pre-beta products from appearing in the /institutions/get_by_id response.
  • Restored the /item/public_token/create and /payment_initiation/payment/token/create endpoints to API version 2020-09-14 to avoid disrupting update mode for end users on older mobile SDKs that do not support Link tokens. These endpoints are still deprecated, and it is recommended you update mobile apps to the latest SDKs as soon as possible.
October 2020
  • Released API version 2020-09-14. See the version changelog for details.
  • Added support for mortgages to /liabilities/get.
  • Released Bank Transfers to closed beta.
  • To improve consistency with other error types, changed the error type for Bank Transfers errors from BANK_TRANSFER to BANK_TRANSFER_ERROR.
  • Added the fields user.phone_number, user_email.address, user.phone_number_verified_time and user.email_address_verified_time to /link/token/create to support the new Returning User Experience, which allows users a more seamless Link flow.
August 2020
  • Introduced standing orders to Payment Initiation for our UK and Europe customers. If applicable, your users will now be able to make recurring scheduled payments with a single authorization.
  • Expanded access to full Auth coverage to more developers. If you would like to use micro-deposit based verification and don't have access to it, contact your Plaid Account Manager.
July 2020
  • Added the ITEM: USER_PERMISSION_REVOKED webhook, which will notify you when a user contacts Plaid directly to delete their data or change their data sharing preferences with your app.

  • Released Link tokens, the new preferred way to use Link, replacing the public key. To learn how to migrate your application to use Link tokens, see the Link token migration guide.

June 2020
  • Added a new merchant_name field to the /transactions/get endpoint for the US and Canada, providing clearer and more consistent merchant names for 95% of existing transactions.
  • Added the PAYMENT_INITIATION:PAYMENT_STATUS_UPDATE webhook, which pushes instant notifications when payment status changes for the UK Payment Initiation product.
  • Added the ability to create payment recipients via sort codes and account numbers, not just IBANs.
May 2020
  • We launched a new open finance platform called Plaid Exchange that enables financial institutions to build a consumer-permissioned data access strategy and strengthen the ability of end users to reliably access their financial data.
April 2020
  • Launched Payment Initiation in the UK, which offers an easy way for users to fund their accounts, make purchases, and pay invoices—all from their favorite apps or websites.
March 2020
  • Added the ability to filter by account_subtype, allowing you to further optimize the Link flow.
  • Added the HOLDINGS: DEFAULT_UPDATE and INVESTMENT_TRANSACTIONS: DEFAULT_UPDATE webhooks, which will fire each time data has successfully refreshed for Holdings and Investments Transactions.
February 2020
  • Added /transactions/refresh, which enables you to pull a user’s transactions on demand.
  • Added /webhook_verification_key/get, which allows you to verify the authenticity of incoming webhooks.
January 2020
  • Added store_number, authorized_date, and payment_channel to the /transactions/get response.
  • Added the investment_transactions.subtypes field to provide more granular detail about the tax, performance, and fee impact of investments transactions.
November 2019
  • Added the status.investments.last_successful_update and status.investments.last_failed_update fields to the data returned by /item/get.
October 2019
  • Added the status.item_logins.breakdown data to /institutions/get_by_id and the Developer Dashboard.
  • Added the routing_numbers field to the Institions object. You can also filter institutions via the options.routing_numbers field in each Institutions API endpoint.
September 2019
  • Added support for credit card details to the Liabilities product.
  • Added Canada-specific account subtypes, including RRSP, RESP, and TFSA, to the Investments product.
August 2019
  • Among numerous other improvements to Liabilities, such as expanded data access, added a new loan_type: cancelled to the Liabilities product.
July 2019
  • We launched Liabilities, which enables developers to access a feed of standardized student loan details from the largest U.S. servicers including Navient, Nelnet, FedLoan, Great Lakes, and many more.
June 2019
  • Launched Investments, which allows developers, fintech apps, and financial institutions to create a holistic view of their customers’ investments.
  • Added the status.transactions_updates field, exposing Transactions health to both the /institutions/get endpoint and the Dasbhaord.
May 2019
  • We enhanced the /identity/get endpoint to now return account-level identity information within the accounts object where available.
  • We released API version 2019.05.29 to enable European institution coverage and provide nomenclature and schema updates required by Identity and future products.
March 2019
  • We updated the institutions endpoints so you can now retrieve bank logos, colors, and website URLs to use to customize your in-app experience.
  • We enabled triggering and testing of webhooks on demand via the new /sandbox/item/fire_webhook endpoint.
February 2019
  • We launched new features for Auth, enabling developers to authenticate accounts from any bank or credit union in the U.S. Link automatically guides end-users to the best way to authenticate their account based on the bank they select.
November 2018
  • Added a new Insights feature, which provides cleaned and categorized transaction data in an Asset Report. In addition to transaction categories, lenders will be able to retrieve merchant names and locations for transactions to use in building risk models.
September 2018
  • We added the /asset_report/refresh endpoint, so you can create a new Asset Report with the latest account balances and transactions for a borrower, based on the old report.
August 2018
  • We added account filtering, which gives you the ability to exclude unnecessary accounts from appearing in an Asset Report.
June 2018
  • Added historical account balances to the PDF version of Asset Reports, bringing them closer in line with the core JSON endpoint.
May 2018
  • We released the 2018-05-22 version of the Plaid API.
  • We enabled distinct API secrets to now be be set for the Sandbox, Development, and Production environments.
  • Added the /sandbox/public_token/create endpoint, which enables the creation of Items in the Sandbox environment directly via the API (without Link).
April 2018
March 2018
  • Rolled out several Assets features, including webhooks for Asset Report generation and full support for Audit Copy token generation and Fannie Mae’s Day 1 Certainty™ program, while improving existing features like pending transaction support in PDF reports.
February 2018
  • Released Assets as a beta product.