---
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 12 revisions.

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

## Changes

- **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-09** `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`
- **2026-08-29** `9ca3e15b9d44`: 18 info
  - added the new optional `query` request parameter `archived`
  - added the new optional `query` request parameter `category`
  - added the new optional `query` request parameter `collectionId`
  - added the new optional `query` request parameter `contentLevel`
  - added the new optional `query` request parameter `created_within`
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `include`
  - added the new optional `query` request parameter `incomplete`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `maxBytes`
  - added the new optional `query` request parameter `projectId`
  - added the new optional `query` request parameter `skill`
  - added the new optional `query` request parameter `sort`
  - added the new optional `query` request parameter `tag`
  - added the new optional `query` request parameter `typeId`
  - added the new optional `query` request parameter `ws`
  - added the optional property `capsules/items/incomplete` to the response with the `200` status

---

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