---
title: "Changes to List document access principals"
method: GET
path: "/api/v1/documents/{identifier}/access-list"
---

# Changes to List document access principals

`GET /api/v1/documents/{identifier}/access-list`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 97 revisions.

- **2026-10-23** `dfcc576cd5f8`: 4 info
- **2026-09-11** `c24bde3d4aa3`: 1 breaking, 1 info

## Changes

- **2026-10-23** `dfcc576cd5f8`: 4 info
  - added the optional property `principals/items/oneOf[#/components/schemas/GroupAccessPrincipal]/userGroupId` to the response with the `200` status
  - added the optional property `principals/items/oneOf[#/components/schemas/UserAccessPrincipal]/userId` to the response with the `200` status
  - response property `principals/items/oneOf[#/components/schemas/GroupAccessPrincipal]/id` deprecated
  - response property `principals/items/oneOf[#/components/schemas/UserAccessPrincipal]/id` deprecated
- **2026-09-11** `c24bde3d4aa3`: 1 breaking, 1 info
  - added `#/components/schemas/UserAccessPrincipal, #/components/schemas/GroupAccessPrincipal` to the `principals/items/` response property `oneOf` list for the response status `200`
  - added discriminator to `principals/items/` response property for the response status `200`

---

[Operation](https://skmtc.dev/omniapp/apis/omni-api/docs/api/v1/documents/:identifier/access-list/get.md) - [API](https://skmtc.dev/omniapp/apis/omni-api.md) - [Page](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/documents/:identifier/access-list/get)