---
title: "Changes to Return a list of rules created for the Item associated with the access token."
method: POST
path: "/beta/transactions/rules/v1/list"
---

# Changes to Return a list of rules created for the Item associated with the access token.

`POST /beta/transactions/rules/v1/list`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 52 revisions.

- **2026-07-22** `a1bbca018160` — 13 warning
- **2026-06-25** `80d23bfdc2e5` — 1 warning
- **2026-06-10** `fb8c3f188d8b` — 1 warning
- **2026-03-04** `ac31f04fdb58` — 1 breaking, 4 warning, 5 info
- **2025-12-11** `465584b48c99` — 2 info
- **2025-11-19** `4abee1c56929` — 1 info
- **2025-11-12** `f8b9f1a85767` — 2 warning
- **2025-10-22** `af4b6e71d87f` — 1 warning
- **2025-03-26** `09cbc8444913` — 2 warning
- **2024-09-04** `a2c34406c317` — 5 warning, 1 info
- **2024-02-21** `5de70cc1e6ca` — 1 breaking, 9 warning, 14 info

## Changes

- **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` — 1 warning
  - added the new `IDEMPOTENCY_ERROR` enum value to the `error_type` response property for the response status `default`
- **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-03-04** `ac31f04fdb58` — 1 breaking, 4 warning, 5 info
  - added the new required request property `client_user_id`
  - removed the request property `access_token`
  - removed the optional property `rules/items/item_id` from the response with the `200` status
  - removed the optional property `rules/items/personal_finance_category` from the response with the `200` status
  - added the new `MERCHANT_NAME` enum value to the `rules/items/rule_details/field` response property for the response status `200`
  - added the optional property `rules/items/pfc_detailed_category` to the response with the `200` status
  - added the optional property `rules/items/pfc_primary_category` to the response with the `200` status
  - added the optional property `rules/items/updated_at` to the response with the `200` status
  - added the optional property `rules/items/user_id` to the response with the `200` status
  - removed the `NAME` enum value from the `rules/items/rule_details/field` response property for the response status `200`
- **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` — 2 warning
  - 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`
- **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-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`
- **2024-09-04** `a2c34406c317` — 5 warning, 1 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 optional property `error_code_reason` to the response with the `default` status
- **2024-02-21** `5de70cc1e6ca` — 1 breaking, 9 warning, 14 info
  - added the new required request property `access_token`
  - removed the request property `client_user_id`
  - 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
  - removed the optional property `rules/items/pfc_detailed_category` from the response with the `200` status
  - removed the optional property `rules/items/pfc_primary_category` from the response with the `200` status
  - removed the optional property `rules/items/updated_at` from the response with the `200` status
  - removed the optional property `rules/items/user_id` from the response with the `200` status
  - added the new `NAME` enum value to the `rules/items/rule_details/field` response property for the response status `200`
  - added the optional property `rules/items/item_id` to the response with the `200` status
  - added the optional property `rules/items/personal_finance_category` to the response with the `200` status
  - 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 `IDEMPOTENCY_ERROR` enum value from the `error_type` response property for the response status `default`
  - removed the `MERCHANT_NAME` enum value from the `rules/items/rule_details/field` response property for the response status `200`
  - 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`

---

[Operation](https://skmtc.dev/plaid/apis/the-plaid-api/docs/beta/transactions/rules/v1/list/post.md) · [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [Page](https://skmtc.dev/plaid/apis/the-plaid-api/changes/beta/transactions/rules/v1/list/post)
