---
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`

## Request

- Base URL: `https://api.smokeball.com`
- URL: `https://api.smokeball.com/matters/{matterId}/documents/folders/{folderId}/history`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

Returns a list of history entries for the specified folder.
            
The response is not paged.

## 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. Possible values: `File`, `Folder`.
    - `changeType` string: The type of change that occurred. Possible values: `Revert`, `Copy`, `CopyToAnotherMatter`, `CopyFromAnotherMatter`, `Restore`, `Rename`, `Move`, `MoveToAnotherMatter`, `MoveFromAnotherMatter`, `Delete`, `Created`, `Modified`, `Cancelled`, `AddedToFavorites`, `RemovedFromFavorites`, `FolderPinned`, `FolderUnpinned`.
    - `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: Unique identifier of the user who is responsible for this change.

## Other responses

- `400`: When a supplied id is not a valid GUID.
- `403`: When the folder does not belong to the specified matter.
- `404`: When folder with the specified id does not exist.

## Changes

- **2026-10-23** `3400f8333094`: 2 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
- **2026-08-26** `db1b8a86b58e`: 2 info
  - added the non-success response with the status `400`
  - removed the non-success response with the status `403`

[Operation history](https://skmtc.dev/smokeball/apis/smokeball-api/changes/matters/:matterId/documents/folders/:folderId/history/get.md)

---

[API](https://skmtc.dev/smokeball/apis/smokeball-api.md) - [All operations](https://skmtc.dev/smokeball/apis/smokeball-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smokeball/apis/smokeball-api/revisions/6e350cf667d4?raw)