---
title: "Get folder history on a matter"
method: GET
path: "/matters/{matterId}/documents/folders/{folderId}/history"
tags: ["Folders"]
---

# Get folder history on a matter

`GET /matters/{matterId}/documents/folders/{folderId}/history`

Returns a list of history entries for the specified folder.

## Path parameters

- `matterId` string, required
- `folderId` string, required

## Response `200`

When request is successful. Returns a collection of 'FileFolderLogEntry' objects.

- FileFolderLogEntryCollection
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable
  - `self` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `value` FileFolderLogEntry[], nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
    - `self` Link
      - `id` string, nullable
      - `href` string, nullable
      - `relation` string, nullable
      - `method` string, nullable
    - `id` string, nullable — Unique identifier of this log entry.
    - `type` string — The type of entity this log entry refers to.
    - `changeType` string — The type of change that occurred.
    - `timestamp` string, date-time — When the client recorded the action (UTC).
    - `file` Link
      - `id` string, nullable
      - `href` string, nullable
      - `relation` string, nullable
      - `method` string, nullable
    - `folder` Link
      - `id` string, nullable
      - `href` string, nullable
      - `relation` string, nullable
      - `method` string, nullable
    - `oldName` string, nullable — Old name prior to a rename operation (when applicable).
    - `newName` string, nullable — New name after a rename operation (when applicable).
    - `oldMatterId` string, nullable — Previous matter identifier (for move/copy across matters).
    - `newMatterId` string, nullable — New matter identifier (for move/copy across matters).
    - `oldFolderId` string, nullable — Previous folder identifier (for move within/between matters).
    - `newFolderId` string, nullable — New folder identifier (for move within/between matters).
    - `copySourceFileId` string, nullable — For copy operations, the source file's identifier when copying a file.
    - `copySourceFolderId` string, nullable — For copy operations, the source folder's identifier when copying a folder.
    - `documentVersionId` string, nullable — Identifier of the document version involved (only for version replace/revert scenarios). Can be used to download particular file versions.
    - `userId` string, nullable — The user who is responsible for this change.

## Other responses

- `403` — When the requested matter does not belong to the account making the request.

---

[API](https://skmtc.net/smokeball/apis/api.md) · [All operations](https://skmtc.net/smokeball/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smokeball/api/revisions/ffc7fffa0d5c/schema)