# Vault epochs

Vault epochs define fixed-duration accounting periods used in vault logic to compute returns, manage liquidity flows, and determine claim availability.

## Structure

Each vault epoch object includes:

* `_id` *(string)* — Unique identifier
* `vaultId` *(string)* — Vault the epoch belongs to
* `vaultAddress` *(string)* — Address of the vault
* `block` *(object)* —
  * `number` *(number)* — Block number
  * `timestamp` *(number)* — Unix timestamp
* `count` *(number)* — Epoch sequence index
* `status` *(string)* — One of: `WAITING`, `RUNNING`, `DEFAULTED`, `CURE`
* `startDate` *(string)* — ISO 8601 start date
* `endDate` *(string)* — ISO 8601 end date
* `startCureDate` *(string)* — When cure phase begins (if applicable)
* `apr` *(number)* — Estimated APR
* `lastApr` *(number)* — APR from previous epoch
* `expectedInterest` *(string)* — Interest forecasted during this epoch
* `unclaimedFees` *(string)* — Fees not yet claimed
* `deposits` *(string)* — Total deposits in epoch
* `duration` *(number)* — Duration in seconds
* `bufferDuration` *(number)* — Buffer window after epoch ends
* `withdrawType` *(string)* — Either `INSTANT` or `STANDARD`
* `withdraws` *(object)* —
  * `amount` *(string)*
  * `fees` *(string)*
* `depositQueue` *(object)* —
  * `amount` *(string)*
  * `lastAmount` *(string)*
  * `isInstant` *(boolean)*
* `withdrawQueue` *(object)* —
  * `amount` *(string)*
  * `lastAmount` *(string)*
  * `isInstant` *(boolean)*
* `instantWithdraws` *(object)* —
  * `allowed` *(boolean)*
  * `delay` *(number)*
  * `amount` *(string)*
  * `aprDelta` *(number)*
  * `deadline` *(string)* — ISO 8601 date
  * `disabled` *(boolean)*
* `createdAt`, `updatedAt` *(string)* — ISO 8601 timestamps
* `createdBy`, `updatedBy` *(string)* — Actor IDs

## Endpoints

{% openapi src="<https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FDsjQoYFYV9f1jzS1GzQR%2FVaultEpochs.yaml?alt=media&token=6204c9c0-61b0-400d-9708-8abb00bd138d>" path="/vault-epochs" method="get" %}
[VaultEpochs.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FDsjQoYFYV9f1jzS1GzQR%2FVaultEpochs.yaml?alt=media\&token=6204c9c0-61b0-400d-9708-8abb00bd138d)
{% endopenapi %}