---
title: "Get the activity of a folder."
method: GET
path: "/actionlog/folder/{folderId}.json"
tags: ["Action logs"]
---

# Get the activity of a folder.

`GET /actionlog/folder/{folderId}.json`

## Request

- Base URL: `https://passbolt.local`
- URL: `https://passbolt.local/actionlog/folder/{folderId}.json`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/passbolt/apis/passbolt-api/docs/actionlog/folder/:folderId.json/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the interpreted activities recorded for a folder. The caller must have access to the folder: a folder that does not exist and a folder the caller cannot see are answered the same way. This route is only registered when the folders plugin is enabled, and an instance without it answers the same 404, so the two cases cannot be told apart from the response.

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Operation is successful.

- object
  - `header` Header, required
    - `id` string, uuid, required
    - `status` 'success' | 'error', required
    - `servertime` integer, required
    - `action` string, uuid, required
    - `message` string, required
    - `url` string, uri, required
    - `code` integer, required
  - `body` Activity[], required
    - `id` string, uuid, required
    - `action_log_id` string, uuid, required: Identifier of the underlying log entry.
    - `type` string, required: The kind of activity, which determines the shape of `data`.
    - `creator` ActivityCreator, required: The author of an activity, reduced to what the activity feed displays.
      - `id` string, uuid, required
      - `username` string, email, required
      - `profile` object, required
        - `id` string, uuid
        - `first_name` string
        - `last_name` string
        - `avatar` object
          - `url` object
            - `medium` string, uri
            - `small` string, uri
    - `created` string, date-time, required
    - `data` object, required: Details of the activity. Its content depends on the value of `type`, so a client should switch on `type` before reading it. Note that for a resource using the v5 encrypted metadata format, `data.resource.name` is null, since the activity reads the cleartext columns.

## Other responses

- `400`: The folder identifier is not a valid UUID.
- `401`: Authentication required.
- `404`: Not found

---

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