---
title: "Changes to Search institutions"
method: POST
path: "/institutions/search"
---

# Changes to Search institutions

`POST /institutions/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 27 of 55 revisions.

- **2026-10-15** `ea443cd78f6f`: 2 breaking, 2 warning
- **2026-10-02** `e07a869352e8`: 2 info
- **2026-08-17** `e536704a333f`: 1 warning, 1 info
- **2026-07-22** `a1bbca018160`: 13 warning
- **2026-06-25** `80d23bfdc2e5`: 2 warning, 1 info
- **2026-06-10** `fb8c3f188d8b`: 1 warning
- **2026-04-02** `7f9a02ad0ce3`: 1 warning, 1 info
- **2026-01-26** `8addecd0b74a`: 1 warning, 1 info
- **2025-12-11** `465584b48c99`: 2 info
- **2025-11-19** `4abee1c56929`: 1 info
- **2025-11-12** `f8b9f1a85767`: 1 breaking, 2 warning, 1 info
- **2025-10-22** `af4b6e71d87f`: 1 warning
- **2025-10-02** `83dc2757b74e`: 1 warning, 1 info
- **2025-09-02** `af95b7b9aa93`: 1 warning, 1 info
- **2025-08-13** `7fc793bb9e85`: 1 warning, 1 info
- **2025-05-21** `5eae3158bbfc`: 1 warning, 1 info
- **2025-04-21** `3b68659a7975`: 2 warning, 2 info
- **2025-03-26** `09cbc8444913`: 2 warning
- **2025-01-15** `5dbeedb71831`: 1 warning, 1 info
- **2024-11-14** `b0263533029b`: 1 warning, 1 info
- **2024-10-09** `36052f62cce1`: 1 breaking, 1 warning, 2 info
- **2024-09-04** `a2c34406c317`: 6 warning, 2 info
- **2024-07-05** `1e30969bd889`: 2 warning, 2 info
- **2024-06-18** `be701ec93161`: 4 warning, 4 info
- **2024-05-03** `1550c043ed31`: 1 info
- **2024-04-17** `943c632a075c`: 1 warning, 1 info
- **2024-02-21** `5de70cc1e6ca`: 20 breaking, 4 warning, 31 info

## Changes

- **2026-10-15** `ea443cd78f6f`: 2 breaking, 2 warning
  - the response property `institutions/items/payment_initiation_metadata/standing_order_metadata/valid_standing_order_intervals` became nullable for the status `200`
  - the response property `institutions/items/payment_initiation_metadata/maximum_payment_amount` became optional for the status `200`
  - added the new `CRA_PARTNER_INSIGHTS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CRA_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- **2026-10-02** `e07a869352e8`: 2 info
  - added the required property `institutions/items/connection_availability` to the response with the `200` status
  - added the required property `institutions/items/payment_initiation_metadata/supports_commercial_payment_consents` to the response with the `200` status
- **2026-08-17** `e536704a333f`: 1 warning, 1 info
  - added the new `cra_home_lending` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_home_lending` enum value to the request property `products/items/`
- **2026-07-22** `a1bbca018160`: 13 warning
  - added the new `ASSETS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CRA_MONITORING_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CREDIT_PROFILE_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `ENCOMPASS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `ENRICH_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `FRAUD_INSIGHTS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `FREDDIE_MAC_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `LINK_DELIVERY_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `PROFILE_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `RECURRING_TRANSACTIONS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `STATEMENTS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSFER_RECURRING_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSFER_REFUND_ERROR` enum value to the `error_type` response property for the response status `default`
- **2026-06-25** `80d23bfdc2e5`: 2 warning, 1 info
  - added the new `IDEMPOTENCY_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `cra_qualify` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_qualify` enum value to the request property `products/items/`
- **2026-06-10** `fb8c3f188d8b`: 1 warning
  - added the new `BASE_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- **2026-04-02** `7f9a02ad0ce3`: 1 warning, 1 info
  - added the new `protect_transactions` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `protect_transactions` enum value to the request property `products/items/`
- **2026-01-26** `8addecd0b74a`: 1 warning, 1 info
  - added the new `cra_plaid_credit_score` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_plaid_credit_score` enum value to the request property `products/items/`
- **2025-12-11** `465584b48c99`: 2 info
  - added the optional property `provided_account_subtypes` to the response with the `default` status
  - added the optional property `required_account_subtypes` to the response with the `default` status
- **2025-11-19** `4abee1c56929`: 1 info
  - removed the `IDENTITY_ERROR` enum value from the `error_type` response property for the response status `default`
- **2025-11-12** `f8b9f1a85767`: 1 breaking, 2 warning, 1 info
  - removed the enum value `cra_plaid_credit_score` of the request property `products/items/`
  - added the new `IDENTITY_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `USER_ERROR` enum value to the `error_type` response property for the response status `default`
  - removed the `cra_plaid_credit_score` enum value from the `institutions/items/products/items/` response property for the response status `200`
- **2025-10-22** `af4b6e71d87f`: 1 warning
  - added the new `SIGNAL_ERROR` enum value to the `error_type` response property for the response status `default`
- **2025-10-02** `83dc2757b74e`: 1 warning, 1 info
  - added the new `cra_lend_score` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_lend_score` enum value to the request property `products/items/`
- **2025-09-02** `af95b7b9aa93`: 1 warning, 1 info
  - added the new `cra_plaid_credit_score` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_plaid_credit_score` enum value to the request property `products/items/`
- **2025-08-13** `7fc793bb9e85`: 1 warning, 1 info
  - added the new `cra_monitoring` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_monitoring` enum value to the request property `products/items/`
- **2025-05-21** `5eae3158bbfc`: 1 warning, 1 info
  - added the new `protect_linked_bank` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `protect_linked_bank` enum value to the request property `products/items/`
- **2025-04-21** `3b68659a7975`: 2 warning, 2 info
  - added the new `AT` enum value to the `institutions/items/country_codes/items/` response property for the response status `200`
  - added the new `FI` enum value to the `institutions/items/country_codes/items/` response property for the response status `200`
  - added the new `AT` enum value to the request property `country_codes/items/`
  - added the new `FI` enum value to the request property `country_codes/items/`
- **2025-03-26** `09cbc8444913`: 2 warning
  - added the new `CHECK_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CONSUMER_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- **2025-01-15** `5dbeedb71831`: 1 warning, 1 info
  - added the new `transactions_refresh` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `transactions_refresh` enum value to the request property `products/items/`
- **2024-11-14** `b0263533029b`: 1 warning, 1 info
  - added the new `cra_network_insights` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_network_insights` enum value to the request property `products/items/`
- **2024-10-09** `36052f62cce1`: 1 breaking, 1 warning, 2 info
  - removed the enum value `deposit_switch` of the request property `products/items/`
  - added the new `pay_by_bank` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `pay_by_bank` enum value to the request property `products/items/`
  - removed the `deposit_switch` enum value from the `institutions/items/products/items/` response property for the response status `200`
- **2024-09-04** `a2c34406c317`: 6 warning, 2 info
  - added the new `PARTNER_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `SANDBOX_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSACTIONS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSACTION_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSFER_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `cra_cashflow_insights` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_cashflow_insights` enum value to the request property `products/items/`
  - added the optional property `error_code_reason` to the response with the `default` status
- **2024-07-05** `1e30969bd889`: 2 warning, 2 info
  - added the new `balance_plus` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `beacon` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `balance_plus` enum value to the request property `products/items/`
  - added the new `beacon` enum value to the request property `products/items/`
- **2024-06-18** `be701ec93161`: 4 warning, 4 info
  - added the new `cra_base_report` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_income_insights` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_partner_insights` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `layer` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `cra_base_report` enum value to the request property `products/items/`
  - added the new `cra_income_insights` enum value to the request property `products/items/`
  - added the new `cra_partner_insights` enum value to the request property `products/items/`
  - added the new `layer` enum value to the request property `products/items/`
- **2024-05-03** `1550c043ed31`: 1 info
  - added the required property `institutions/items/payment_initiation_metadata/supports_payment_consents` to the response with the `200` status
- **2024-04-17** `943c632a075c`: 1 warning, 1 info
  - added the new `profile` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `profile` enum value to the request property `products/items/`
- **2024-02-21** `5de70cc1e6ca`: 20 breaking, 4 warning, 31 info
  - removed the enum value `AT` of the request property `country_codes/items/`
  - removed the enum value `FI` of the request property `country_codes/items/`
  - removed the enum value `balance_plus` of the request property `products/items/`
  - removed the enum value `beacon` of the request property `products/items/`
  - removed the enum value `cra_base_report` of the request property `products/items/`
  - removed the enum value `cra_cashflow_insights` of the request property `products/items/`
  - removed the enum value `cra_income_insights` of the request property `products/items/`
  - removed the enum value `cra_lend_score` of the request property `products/items/`
  - removed the enum value `cra_monitoring` of the request property `products/items/`
  - removed the enum value `cra_network_insights` of the request property `products/items/`
  - removed the enum value `cra_partner_insights` of the request property `products/items/`
  - removed the enum value `cra_plaid_credit_score` of the request property `products/items/`
  - removed the enum value `cra_qualify` of the request property `products/items/`
  - removed the enum value `layer` of the request property `products/items/`
  - removed the enum value `pay_by_bank` of the request property `products/items/`
  - removed the enum value `profile` of the request property `products/items/`
  - removed the enum value `protect_linked_bank` of the request property `products/items/`
  - removed the enum value `protect_transactions` of the request property `products/items/`
  - removed the enum value `transactions_refresh` of the request property `products/items/`
  - removed the required property `institutions/items/payment_initiation_metadata/supports_payment_consents` from the response with the `200` status
  - removed the optional property `error_code_reason` from the response with the `default` status
  - removed the optional property `provided_account_subtypes` from the response with the `default` status
  - removed the optional property `required_account_subtypes` from the response with the `default` status
  - added the new `deposit_switch` enum value to the `institutions/items/products/items/` response property for the response status `200`
  - added the new `deposit_switch` enum value to the request property `products/items/`
  - removed the `AT` enum value from the `institutions/items/country_codes/items/` response property for the response status `200`
  - removed the `BASE_REPORT_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `CHECK_REPORT_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `CONSUMER_REPORT_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `FI` enum value from the `institutions/items/country_codes/items/` response property for the response status `200`
  - removed the `IDEMPOTENCY_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `PARTNER_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `SANDBOX_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `SIGNAL_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `TRANSACTIONS_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `TRANSACTION_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `TRANSFER_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `USER_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `balance_plus` enum value from the `institutions/items/products/items/` response property for the response status `200`
  - removed the `beacon` enum value from the `institutions/items/products/items/` response property for the response status `200`
  - …15 more

---

[Operation](https://skmtc.dev/plaid/apis/the-plaid-api/docs/institutions/search/post.md) - [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) - [Page](https://skmtc.dev/plaid/apis/the-plaid-api/changes/institutions/search/post)
