---
title: "Changes to List capsules visible to the caller"
method: GET
path: "/api/preview/capsules"
---

# Changes to List capsules visible to the caller

`GET /api/preview/capsules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 9 revisions.

- **2026-11-08** `fd7b0a7085e4`: 2 info
- **2026-10-27** `3a2c4ebeab51`: 3 info
- **2026-10-19** `5778844d1f9e`: 1 info
- **2026-10-10** `c7729725d527`: 2 info
- **2026-09-30** `6a95af57f0f6`: 8 breaking, 3 info
- **2026-09-12** `74a5f960149b`: 4 breaking, 13 info

## Changes

- **2026-11-08** `fd7b0a7085e4`: 2 info
  - added the new optional `query` request parameter `stale_reason`
  - added the optional property `capsules/items/stale_reasons` to the response with the `200` status
- **2026-10-27** `3a2c4ebeab51`: 3 info
  - added the new optional `query` request parameter `shape`
  - added the optional property `capsules/items/log/owner_ref` to the response with the `200` status
  - added the optional property `type` to the response with the `200` status
- **2026-10-19** `5778844d1f9e`: 1 info
  - added the optional property `capsules/items/viewer_can_write` to the response with the `200` status
- **2026-10-10** `c7729725d527`: 2 info
  - added the new optional `query` request parameter `select`
  - added the optional property `capsules/items/ref` to the response with the `200` status
- **2026-09-30** `6a95af57f0f6`: 8 breaking, 3 info
  - removed the enum value `archived_newest` from the `query` request parameter `sort`
  - removed the enum value `archived_oldest` from the `query` request parameter `sort`
  - removed the enum value `newest` from the `query` request parameter `sort`
  - removed the enum value `oldest` from the `query` request parameter `sort`
  - removed the enum value `ref_asc` from the `query` request parameter `sort`
  - removed the enum value `ref_desc` from the `query` request parameter `sort`
  - removed the enum value `title_asc` from the `query` request parameter `sort`
  - removed the enum value `updated` from the `query` request parameter `sort`
  - added the new optional `query` request parameter `aggregate`
  - added the new optional `query` request parameter `filter`
  - added the optional property `aggregate` to the response with the `200` status
- **2026-09-12** `74a5f960149b`: 4 breaking, 13 info
  - removed the enum value `24h` from the `query` request parameter `created_within`
  - removed the enum value `30d` from the `query` request parameter `created_within`
  - removed the enum value `7d` from the `query` request parameter `created_within`
  - added the pattern `^[1-9][0-9]{0,3}[hdw]$` to the `query` request parameter `created_within`
  - added the new optional `query` request parameter `archived_after`
  - added the new optional `query` request parameter `archived_before`
  - added the new optional `query` request parameter `archived_period`
  - added the new optional `query` request parameter `archived_within`
  - added the new optional `query` request parameter `created_after`
  - added the new optional `query` request parameter `created_before`
  - added the new optional `query` request parameter `created_period`
  - added the new optional `query` request parameter `stale`
  - added the new optional `query` request parameter `tz`
  - added the new optional `query` request parameter `updated_after`
  - added the new optional `query` request parameter `updated_before`
  - added the new optional `query` request parameter `updated_period`
  - added the new optional `query` request parameter `updated_within`

---

[Operation](https://skmtc.dev/symbol-chat/apis/symbol-api/docs/api/preview/capsules/get.md) - [API](https://skmtc.dev/symbol-chat/apis/symbol-api.md) - [Page](https://skmtc.dev/symbol-chat/apis/symbol-api/changes/api/preview/capsules/get)