From f1fb401632965efcd973162ce2cd39d4c9b1e38b Mon Sep 17 00:00:00 2001 From: hmansour-codat Date: Mon, 15 Jun 2026 13:53:41 +0100 Subject: [PATCH 1/5] docs(lending): add CBS report retention policy to Supported Outputs Documents the two-layer retention behaviour for categorized bank statement reports: - Time-based: ~90-day window for all report types - Count-based (CBS only): only the latest report is retained; previous reports are removed when a new one is generated Includes guidance to use /latest endpoint and explains expected 404 behaviour on superseded reportIds. Refs: MED-814 --- docs/lending/features/bank-statements-overview.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/lending/features/bank-statements-overview.md b/docs/lending/features/bank-statements-overview.md index dbdd560c5..b3a6182e0 100644 --- a/docs/lending/features/bank-statements-overview.md +++ b/docs/lending/features/bank-statements-overview.md @@ -203,6 +203,21 @@ if err == nil && statementResponse.StatusCode == 200 { +#### Report retention + +Categorized bank statement reports are subject to two layers of retention: + +- **Time-based:** all reports are retained for approximately 90 days from generation, after which they are automatically removed. +- **Count-based (categorized bank statements only):** only the most recent report is retained. When a new report is generated, the previous report is immediately deleted, even if it is still within the 90-day window. + +Because categorized bank statements are cumulative — each report contains all transactions from connected accounts to date — the latest report always includes all data from prior reports. We recommend fetching the most recent report using the [`/latest` endpoint](/lending-api#/operations/get-categorized-bank-statement) rather than storing and re-requesting a specific `reportId`. + +:::note 404 on older report IDs + +Requesting a superseded `reportId` via `GET /reports/{reportId}` returns a **404** response. This is expected — the report has been removed by the retention policy, not due to an error. Always use `/latest` to reliably retrieve the current report. + +::: + ## Get started Once you have the Lending solution enabled, configure your instance to work with our bank statements feature. From 3e140de855a7c634cf6eb37c81570e7ab4d03381 Mon Sep 17 00:00:00 2001 From: hmansour-codat Date: Mon, 15 Jun 2026 14:00:25 +0100 Subject: [PATCH 2/5] revert(lending): remove CBS retention section from bank-statements-overview Removed the report retention section detailing time-based and count-based retention policies for categorized bank statement reports. --- docs/lending/features/bank-statements-overview.md | 15 --------------- 1 file changed, 15 deletions(-) diff --git a/docs/lending/features/bank-statements-overview.md b/docs/lending/features/bank-statements-overview.md index b3a6182e0..dbdd560c5 100644 --- a/docs/lending/features/bank-statements-overview.md +++ b/docs/lending/features/bank-statements-overview.md @@ -203,21 +203,6 @@ if err == nil && statementResponse.StatusCode == 200 { -#### Report retention - -Categorized bank statement reports are subject to two layers of retention: - -- **Time-based:** all reports are retained for approximately 90 days from generation, after which they are automatically removed. -- **Count-based (categorized bank statements only):** only the most recent report is retained. When a new report is generated, the previous report is immediately deleted, even if it is still within the 90-day window. - -Because categorized bank statements are cumulative — each report contains all transactions from connected accounts to date — the latest report always includes all data from prior reports. We recommend fetching the most recent report using the [`/latest` endpoint](/lending-api#/operations/get-categorized-bank-statement) rather than storing and re-requesting a specific `reportId`. - -:::note 404 on older report IDs - -Requesting a superseded `reportId` via `GET /reports/{reportId}` returns a **404** response. This is expected — the report has been removed by the retention policy, not due to an error. Always use `/latest` to reliably retrieve the current report. - -::: - ## Get started Once you have the Lending solution enabled, configure your instance to work with our bank statements feature. From 8394d3347946daa4864a68367cfc96a6d1898d46 Mon Sep 17 00:00:00 2001 From: hmansour-codat Date: Wed, 17 Jun 2026 11:40:55 +0100 Subject: [PATCH 3/5] docs(lending): add CBS report retention policy to excel-download Supported Outputs Added report retention details for categorized bank statement reports, including time-based and count-based retention policies. --- docs/lending/features/excel-download-overview.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/lending/features/excel-download-overview.md b/docs/lending/features/excel-download-overview.md index fd71ef73e..68cc30308 100644 --- a/docs/lending/features/excel-download-overview.md +++ b/docs/lending/features/excel-download-overview.md @@ -216,6 +216,21 @@ You can also generate and download a report in an Excel format via the [Portal]( You can also generate and download the **data export** report by clicking the **Export data** button on any of the Lending screens of the Portal. + +#### Report retention + +Categorized bank statement reports are subject to two layers of retention: + +- **Time-based:** all reports are retained for approximately 90 days from generation, after which they are automatically removed. +- **Count-based (categorized bank statements only):** only the most recent report is retained. When a new report is generated, the previous report is immediately deleted, even if it is still within the 90-day window. + +Because categorized bank statements are cumulative — each report contains all transactions from connected accounts to date — the latest report always includes all data from prior reports. We recommend fetching the most recent report using the [`/latest` endpoint](/lending-api#/operations/get-categorized-bank-statement) rather than storing and re-requesting a specific `reportId`. + +:::note 404 on older report IDs + +Requesting a superseded `reportId` via `GET /reports/{reportId}` returns a **404** response. This is expected — the report has been removed by the retention policy, not due to an error. Always use `/latest` to reliably retrieve the current report. + +::: --- ## Read next From a8d517baf29678517afb6728e2c95b913b5d79bc Mon Sep 17 00:00:00 2001 From: hmansour-codat Date: Wed, 17 Jun 2026 11:45:33 +0100 Subject: [PATCH 4/5] Update report retention section for clarity --- docs/lending/features/excel-download-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lending/features/excel-download-overview.md b/docs/lending/features/excel-download-overview.md index 68cc30308..0671477a6 100644 --- a/docs/lending/features/excel-download-overview.md +++ b/docs/lending/features/excel-download-overview.md @@ -219,7 +219,7 @@ You can also generate and download the **data export** report by clicking the ** #### Report retention -Categorized bank statement reports are subject to two layers of retention: +Lending reports are subject to two layers of retention: - **Time-based:** all reports are retained for approximately 90 days from generation, after which they are automatically removed. - **Count-based (categorized bank statements only):** only the most recent report is retained. When a new report is generated, the previous report is immediately deleted, even if it is still within the 90-day window. From 9586311322fcd9a90a06ec5e899d5c35f713f328 Mon Sep 17 00:00:00 2001 From: hmansour-codat Date: Wed, 17 Jun 2026 13:02:52 +0100 Subject: [PATCH 5/5] Fix formatting in excel-download-overview.md Removed extra line break before the 'Report retention' section. --- docs/lending/features/excel-download-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lending/features/excel-download-overview.md b/docs/lending/features/excel-download-overview.md index 0671477a6..2f8472c02 100644 --- a/docs/lending/features/excel-download-overview.md +++ b/docs/lending/features/excel-download-overview.md @@ -216,7 +216,6 @@ You can also generate and download a report in an Excel format via the [Portal]( You can also generate and download the **data export** report by clicking the **Export data** button on any of the Lending screens of the Portal. - #### Report retention Lending reports are subject to two layers of retention: @@ -231,6 +230,7 @@ Because categorized bank statements are cumulative — each report contains all Requesting a superseded `reportId` via `GET /reports/{reportId}` returns a **404** response. This is expected — the report has been removed by the retention policy, not due to an error. Always use `/latest` to reliably retrieve the current report. ::: + --- ## Read next