---
title: "Changes to Retrieve the reports associated with a relay token that was shared with you"
method: POST
path: "/credit/relay/get"
---

# Changes to Retrieve the reports associated with a relay token that was shared with you

`POST /credit/relay/get`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 19 of 52 revisions.

- **2026-08-17** `e536704a333f` — 5 warning, 1 info
- **2026-07-22** `a1bbca018160` — 31 warning
- **2026-06-25** `80d23bfdc2e5` — 2 warning
- **2026-06-10** `fb8c3f188d8b` — 2 warning
- **2026-04-17** `b9a2871636de` — 1 warning
- **2026-04-02** `7f9a02ad0ce3` — 7 warning
- **2025-12-11** `465584b48c99` — 4 info
- **2025-11-19** `4abee1c56929` — 2 info
- **2025-11-12** `f8b9f1a85767` — 12 breaking, 32 warning, 30 info
- **2025-10-22** `af4b6e71d87f` — 1 warning, 2 info
- **2025-08-13** `7fc793bb9e85` — 1 info
- **2025-07-21** `221797022378` — 1 warning
- **2025-03-26** `09cbc8444913` — 15 breaking, 2 warning, 3 info
- **2024-11-14** `b0263533029b` — 1 breaking
- **2024-09-04** `a2c34406c317` — 5 warning, 5 info
- **2024-07-05** `1e30969bd889` — 1 warning
- **2024-06-18** `be701ec93161` — 1 info
- **2024-05-03** `1550c043ed31` — 1 info
- **2024-02-21** `5de70cc1e6ca` — 13 warning, 36 info

## Changes

- **2026-08-17** `e536704a333f` — 5 warning, 1 info
  - added the new `charge card` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `commercial line of credit` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `home equity loan` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `installment` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `prediction market` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the optional property `report/items/items/accounts/items/investments/holdings/items/tax_lots` to the response with the `200` status
- **2026-07-22** `a1bbca018160` — 31 warning
  - 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 `BANK_INCOME_INSIGHTS_INCOMPLETE` enum value to the `warnings/items/warning_code` response property for the response status `200`
  - added the new `BANK_INCOME_INSIGHTS_INSUFFICIENT_DATA` enum value to the `warnings/items/warning_code` response property for the response status `200`
  - added the new `BANK_INCOME_INSIGHTS_INTERNAL_ERROR` enum value to the `warnings/items/warning_code` response property for the response status `200`
  - added the new `BANK_INCOME_INSIGHTS_MISMATCHED_DAYS_REQUESTED` enum value to the `warnings/items/warning_code` response property for the response status `200`
  - added the new `BANK_INCOME_INSIGHTS_STATUS_IN_PROGRESS` enum value to the `warnings/items/warning_code` 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`
- **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
  - 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`
- **2026-04-17** `b9a2871636de` — 1 warning
  - added the new `limited purpose checking` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
- **2026-04-02** `7f9a02ad0ce3` — 7 warning
  - added the new `fhsa` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `qshr` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `roth 403B` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `roth 457b` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `roth pension` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `roth profit sharing plan` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `roth thrift savings plan` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
- **2025-12-11** `465584b48c99` — 4 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
  - 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` — 2 info
  - 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` — 12 breaking, 32 warning, 30 info
  - the `report/insights/affordability/expenditure/essential_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/insights/affordability/expenditure/non_essential_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/insights/affordability/expenditure/other/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/insights/affordability/expenditure/total_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/insights/affordability/expenditure/transfers_out/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/insights/risk/loan_disbursements/category_details` response's property type/format changed from ``/`` to `array`/`` for status `200`
  - the `report/items/items/accounts/items/account_insights/affordability/expenditure/essential_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/items/items/accounts/items/account_insights/affordability/expenditure/non_essential_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/items/items/accounts/items/account_insights/affordability/expenditure/other/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/items/items/accounts/items/account_insights/affordability/expenditure/total_expenditure/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/items/items/accounts/items/account_insights/affordability/expenditure/transfers_out/amount` response's property type/format changed from `object`/`` to `number`/`double` for status `200`
  - the `report/items/items/accounts/items/account_insights/risk/loan_disbursements/category_details` response's property type/format changed from ``/`` to `array`/`` for status `200`
  - removed the optional property `report/insights/affordability/expenditure/essential_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/essential_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/essential_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/non_essential_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/non_essential_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/non_essential_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/other/amount/amount` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/other/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/other/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/total_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/total_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/total_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/transfers_out/amount/amount` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/transfers_out/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/insights/affordability/expenditure/transfers_out/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/essential_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/essential_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/essential_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/non_essential_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/non_essential_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/non_essential_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/other/amount/amount` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/other/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/other/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/total_expenditure/amount/amount` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/total_expenditure/amount/iso_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/total_expenditure/amount/unofficial_currency_code` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights/affordability/expenditure/transfers_out/amount/amount` from the response with the `200` status
  - …34 more
- **2025-10-22** `af4b6e71d87f` — 1 warning, 2 info
  - 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`
  - added the optional property `report/insights` to the response with the `200` status
  - added the optional property `report/items/items/accounts/items/account_insights` to the response with the `200` status
- **2025-08-13** `7fc793bb9e85` — 1 info
  - response property `report/items/items/accounts/items/transactions/items/name` deprecated
- **2025-07-21** `221797022378` — 1 warning
  - removed the optional property `report/items/items/accounts/items/holder_category` from the response with the `200` status
- **2025-03-26** `09cbc8444913` — 15 breaking, 2 warning, 3 info
  - removed the required property `report/items/items/accounts/items/investments/account_id` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/amount` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/date` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/fees` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/investment_transaction_id` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/iso_currency_code` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/name` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/price` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/quantity` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/security_id` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/subtype` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/type` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/unofficial_currency_code` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/vested_quantity` from the response with the `200` status
  - removed the required property `report/items/items/accounts/items/investments/vested_value` from the response with the `200` status
  - added the new `CHECK_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 `CONSUMER_REPORT_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/accounts/items/investments/holdings` to the response with the `200` status
  - added the optional property `report/items/items/accounts/items/investments/securities` to the response with the `200` status
  - added the optional property `report/items/items/accounts/items/investments/transactions` to the response with the `200` status
- **2024-11-14** `b0263533029b` — 1 breaking
  - the response property `warnings/items/cause` became nullable for the status `200`
- **2024-09-04** `a2c34406c317` — 5 warning, 5 info
  - added the new `PARTNER_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - added the new `SANDBOX_ERROR` enum value to the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - added the new `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 `TRANSACTION_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_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 `warnings/items/cause/allOf[subschema #1: Error]/error_code_reason` to the response with the `200` status
  - removed the `recurring` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `rewards` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `safe deposit` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `undefined` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
- **2024-07-05** `1e30969bd889` — 1 warning
  - removed the optional property `report/items/items/accounts/items/owners/items/document_id` from the response with the `200` status
- **2024-06-18** `be701ec93161` — 1 info
  - added the optional property `report/items/items/accounts/items/holder_category` to the response with the `200` status
- **2024-05-03** `1550c043ed31` — 1 info
  - added the new optional request property `include_insights`
- **2024-02-21** `5de70cc1e6ca` — 13 warning, 36 info
  - removed the request property `include_insights`
  - removed the optional property `report/insights` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/account_insights` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/investments/holdings` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/investments/securities` from the response with the `200` status
  - removed the optional property `report/items/items/accounts/items/investments/transactions` from the response with the `200` status
  - removed the optional property `warnings/items/cause/allOf[subschema #1: Error]/error_code_reason` from the response with the `200` status
  - removed the optional property `warnings/items/cause/allOf[subschema #1: Error]/provided_account_subtypes` from the response with the `200` status
  - removed the optional property `warnings/items/cause/allOf[subschema #1: Error]/required_account_subtypes` from the response with the `200` status
  - added the new `recurring` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `rewards` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `safe deposit` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the new `undefined` enum value to the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - added the optional property `report/items/items/accounts/items/owners/items/document_id` to the response with the `200` status
  - removed the `BASE_REPORT_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `CHECK_REPORT_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `CONSUMER_REPORT_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `IDEMPOTENCY_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `PARTNER_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `SANDBOX_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `SIGNAL_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `TRANSACTIONS_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `TRANSACTION_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `TRANSFER_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `USER_ERROR` enum value from the `warnings/items/cause/allOf[subschema #1: Error]/error_type` response property for the response status `200`
  - removed the `fhsa` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `limited purpose checking` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `qshr` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `roth 403B` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `roth 457b` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `roth pension` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `roth profit sharing plan` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - removed the `roth thrift savings plan` enum value from the `report/items/items/accounts/items/subtype` response property for the response status `200`
  - response property `report/items/items/accounts/items/transactions/items/name` reactivated
  - added the required property `report/items/items/accounts/items/investments/account_id` to the response with the `200` status
  - added the required property `report/items/items/accounts/items/investments/amount` to the response with the `200` status
  - added the required property `report/items/items/accounts/items/investments/date` to the response with the `200` status
  - added the required property `report/items/items/accounts/items/investments/fees` to the response with the `200` status
  - added the required property `report/items/items/accounts/items/investments/investment_transaction_id` to the response with the `200` status
  - added the required property `report/items/items/accounts/items/investments/iso_currency_code` to the response with the `200` status
  - …9 more

---

[Operation](https://skmtc.dev/plaid/apis/the-plaid-api/docs/credit/relay/get/post.md) · [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [Page](https://skmtc.dev/plaid/apis/the-plaid-api/changes/credit/relay/get/post)
