--- title: "Changes to Retrieve income insights from your user's banks" method: POST path: "/cra/check_report/income_insights/get" --- # Changes to Retrieve income insights from your user's banks `POST /cra/check_report/income_insights/get` > Every recorded change to this operation, newest first. ## Timeline Changed in 21 of 55 revisions. - **2026-10-15** `ea443cd78f6f`: 4 warning - **2026-10-02** `e07a869352e8`: 2 breaking - **2026-08-17** `e536704a333f`: 2 info - **2026-07-22** `a1bbca018160`: 26 warning, 5 info - **2026-06-25** `80d23bfdc2e5`: 2 warning - **2026-06-10** `fb8c3f188d8b`: 2 warning, 1 info - **2026-04-17** `b9a2871636de`: 1 warning, 4 info - **2025-12-11** `465584b48c99`: 1 breaking, 1 warning, 4 info - **2025-11-19** `4abee1c56929`: 1 warning, 2 info - **2025-11-12** `f8b9f1a85767`: 2 warning, 2 info - **2025-10-22** `af4b6e71d87f`: 1 warning - **2025-10-02** `83dc2757b74e`: 1 breaking, 1 warning - **2025-09-02** `af95b7b9aa93`: 1 info - **2025-08-13** `7fc793bb9e85`: 2 info - **2025-03-26** `09cbc8444913`: 2 info - **2024-11-14** `b0263533029b`: 1 info - **2024-10-09** `36052f62cce1`: 2 info - **2024-09-04** `a2c34406c317`: 2 warning, 41 info - **2024-07-05** `1e30969bd889`: 1 warning - **2024-06-18** `be701ec93161`: 1 info - **2024-02-21** `5de70cc1e6ca`: 1 breaking ## Changes - **2026-10-15** `ea443cd78f6f`: 4 warning - added the new `CRA_PARTNER_INSIGHTS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `CRA_PARTNER_INSIGHTS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `CRA_REPORT_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `CRA_REPORT_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - **2026-10-02** `e07a869352e8`: 2 breaking - the response property `report/items/items/accounts/items/owners/items/addresses/items/data/street` became nullable for the status `200` - the response property `report/items/items/bank_income_accounts/items/owners/items/addresses/items/data/street` became nullable for the status `200` - **2026-08-17** `e536704a333f`: 2 info - the security scope `cra:read` was added to the endpoint's security scheme `oauth2` - the security scope `cra:report:read` was removed from the endpoint's security scheme `oauth2` - **2026-07-22** `a1bbca018160`: 26 warning, 5 info - added the new `ASSETS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `ASSETS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `CRA_MONITORING_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `CRA_MONITORING_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `CREDIT_PROFILE_REPORT_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 `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `ENCOMPASS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `ENCOMPASS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `ENRICH_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `ENRICH_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `FRAUD_INSIGHTS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `FRAUD_INSIGHTS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `FREDDIE_MAC_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `FREDDIE_MAC_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `LINK_DELIVERY_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `LINK_DELIVERY_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `PROFILE_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `PROFILE_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `RECURRING_TRANSACTIONS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `RECURRING_TRANSACTIONS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `STATEMENTS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `STATEMENTS_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `TRANSFER_RECURRING_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `TRANSFER_RECURRING_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `TRANSFER_REFUND_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `TRANSFER_REFUND_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - the endpoint scheme security `clientId AND secret AND plaidVersion` was added to the API - the endpoint scheme security `oauth2` was added to the API - added the new optional request property `consumer_report_permissible_purpose` - added the new optional request property `report_id` - request property `options` deprecated - **2026-06-25** `80d23bfdc2e5`: 2 warning - added the new `IDEMPOTENCY_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `IDEMPOTENCY_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - **2026-06-10** `fb8c3f188d8b`: 2 warning, 1 info - added the new `BASE_REPORT_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `BASE_REPORT_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - the response property `report/income_streams` became required for the status `200` - **2026-04-17** `b9a2871636de`: 1 warning, 4 info - added the new `limited purpose checking` enum value to the `report/items/items/bank_income_accounts/items/subtype` response property for the response status `200` - added the new optional request property `options` - added the optional property `report/income_streams` to the response with the `200` status - added the optional property `report/items/items/accounts` to the response with the `200` status - added the optional property `report/user_summary` to the response with the `200` status - **2025-12-11** `465584b48c99`: 1 breaking, 1 warning, 4 info - the `user_id` request property type changed from no type to `string` - removed `#/components/schemas/NewUserID` from the `user_id` request property `allOf` list - 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 - added the optional property `warnings/items/cause/allOf[subschema #1: Error]/provided_account_subtypes` to the response with the `200` status - added the optional property `warnings/items/cause/allOf[subschema #1: Error]/required_account_subtypes` to the response with the `200` status - **2025-11-19** `4abee1c56929`: 1 warning, 2 info - removed `subschema #2` from the `user_id` request property `allOf` list - removed the `IDENTITY_ERROR` enum value from the `error_type` response property for the response status `default` - removed the `IDENTITY_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - **2025-11-12** `f8b9f1a85767`: 2 warning, 2 info - added the new `IDENTITY_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the new `USER_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - added the optional property `report/items/items/bank_income_sources/items/status` to the response with the `200` status - added the required property `report/items/items/bank_income_sources/items/income_provider` to the response with the `200` status - **2025-10-22** `af4b6e71d87f`: 1 warning - added the new `SIGNAL_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200` - **2025-10-02** `83dc2757b74e`: 1 breaking, 1 warning - added `subschema #2` to the `user_id` request property `allOf` list - removed `subschema #2, subschema #3` from the `user_id` request property `allOf` list - **2025-09-02** `af95b7b9aa93`: 1 info - added the new optional request property `user_id` - **2025-08-13** `7fc793bb9e85`: 2 info - response property `report/bank_income_summary/historical_summary/items/transactions/items/name` deprecated - response property `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/name` deprecated - **2025-03-26** `09cbc8444913`: 2 info - added the optional property `report/client_report_id` to the response with the `200` status - added the optional property `warnings` to the response with the `200` status - **2024-11-14** `b0263533029b`: 1 info - added the required property `report/items/items/bank_income_accounts/items/metadata` to the response with the `200` status - **2024-10-09** `36052f62cce1`: 2 info - added the new optional request property `third_party_user_token` - the request property `user_token` became optional - **2024-09-04** `a2c34406c317`: 2 warning, 41 info - added the new `undefined` enum value to the `report/bank_income_summary/historical_summary/items/transactions/items/bonus_type` response property for the response status `200` - added the new `undefined` enum value to the `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/bonus_type` response property for the response status `200` - the response property `report/bank_income_summary/forecasted_annual_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/forecasted_annual_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/forecasted_annual_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/forecasted_average_monthly_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/forecasted_average_monthly_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/forecasted_average_monthly_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_gross_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_gross_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_gross_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_annual_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_gross_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_gross_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_gross_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_income/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_income/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_average_monthly_income/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/total_amounts/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/total_amounts/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/total_amounts/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/amount` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/date` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/original_description` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/pending` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/transaction_id` became required for the status `200` - the response property `report/bank_income_summary/historical_summary/items/transactions/items/unofficial_currency_code` became required for the status `200` - the response property `report/bank_income_summary/total_amounts/items/amount` became required for the status `200` - the response property `report/bank_income_summary/total_amounts/items/iso_currency_code` became required for the status `200` - the response property `report/bank_income_summary/total_amounts/items/unofficial_currency_code` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/total_amounts/items/amount` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/total_amounts/items/iso_currency_code` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/total_amounts/items/unofficial_currency_code` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/amount` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/date` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/iso_currency_code` became required for the status `200` - the response property `report/items/items/bank_income_sources/items/historical_summary/items/transactions/items/original_description` became required for the status `200` - …3 more - **2024-07-05** `1e30969bd889`: 1 warning - removed the optional property `report/items/items/bank_income_accounts/items/owners/items/document_id` from the response with the `200` status - **2024-06-18** `be701ec93161`: 1 info - endpoint added - **2024-02-21** `5de70cc1e6ca`: 1 breaking - api path removed without deprecation --- [Operation](https://skmtc.dev/plaid/apis/the-plaid-api/docs/cra/check_report/income_insights/get/post.md) - [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) - [Page](https://skmtc.dev/plaid/apis/the-plaid-api/changes/cra/check_report/income_insights/get/post)