---
title: "Get cycle snapshot for deposit account"
method: GET
path: "/v1/deposits/accounts/{accountId}/cycle-snapshot"
tags: ["Deposit account lifecycle"]
---

# Get cycle snapshot for deposit account

`GET /v1/deposits/accounts/{accountId}/cycle-snapshot`

## Request

- Base URL: `https://sandbox.pismolabs.io/savings-products`
- URL: `https://sandbox.pismolabs.io/savings-products/v1/deposits/accounts/{accountId}/cycle-snapshot`
- Auth: HTTP bearer

Return a consolidated point‑in‑time snapshot of a deposit account lifecycle, providing current and previous cycle details such as active and prior product attachments, key dates (cycle start, maturity, rollover), interest plan information, and principal context to support audit, statement, and reconciliation use cases.

## Path parameters

- `accountId` integer, required

## Response `200`

Cycle snapshot returned successfully

- CycleSnapshotResponse: Provides a point in time representation of a deposit account lifecycle. Includes the current state and the previous cycle’s key attributes, such as product and attachment references, interest plan context, lifecycle dates, and principal details. Supports audit, statement, and reconciliation workflows without requiring clients to reassemble the account’s history from individual events. The lifecycle dates in this response (`cycle_start_date`, `current_calendar_maturity_date`, `current_rollover_date`, and the grace window) are anchored at 00:00 in the account’s division timezone. When the division has no timezone configured, they are resolved in UTC.
  - `account_id` integer: Deposit account ID
  - `status` 'ACTIVE' | 'INACTIVE': Cycle status, this can be either `ACTIVE` or `INACTIVE`
  - `current_product_id` string: Product ID currently attached to the account
  - `current_attachment_id` string: Current attachment ID
  - `current_interest_plan_id` string: Current interest plan ID
  - `current_grace_period` integer: Grace‑period duration in days for the current cycle. For non‑first cycles, the grace window opens at the start of the cycle, spanning `cycle_start_date`, `cycle_start_date` + `current_grace_period`. The first cycle does not include a grace window.
  - `current_rollover_date` string, date-time: Date the current cycle rolls into the next one (`current_calendar_maturity_date` + 1 or the next cycle’s `cycle_start_date`). Rollover occurs at the maturity date, so grace no longer sits between maturity and rollover. Format = `yyyy-mm-ddThh:mm:ss.sssZ`.
  - `current_calendar_maturity_date` string, date-time: Maturity date of the current cycle. Uses inclusive day count (day 1 is `cycle_start_date`). For the first cycle, the maturity date is `cycle_start_date` + term - 1. For a renewed cycle, the maturity date is `cycle_start_date` + `current_grace_period` + term - 1 because grace extends the cycle. Format = `yyyy-mm-ddThh:mm:ss.sssZ`.
  - `previous_product_id` string: Previous product ID
  - `previous_attachment_id` string: Previous attachment ID
  - `previous_interest_plan_id` string: Previous interest plan ID
  - `previous_grace_period` integer: Previous grace period in days
  - `previous_calendar_maturity_date` string, date-time, nullable: Previous calendar maturity date. The datetime format follows the ISO 8601 standard `yyyy-mm-ddThh:mm:ss.sssZ`.
  - `cycle_start_date` string, date-time: Cycle start date. The datetime format follows the ISO 8601 standard `yyyy-mm-ddThh:mm:ss.sssZ`.
  - `start_date` string, date-time: Start date of the cycle. The datetime format follows the ISO 8601 standard `yyyy-mm-ddThh:mm:ss.sssZ`.

## Other responses

- `400`: Bad request
- `403`: Forbidden
- `404`: Bad request
- `500`: Internal error

---

[API](https://skmtc.dev/pismo/apis/banking-interest-bearing-accounts.md) - [All operations](https://skmtc.dev/pismo/apis/banking-interest-bearing-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-interest-bearing-accounts/revisions/c68f61feb8a8?raw)