---
title: "List reports"
method: GET
path: "/2/drive/{drive_id}/activities/reports"
tags: ["Drive > Activity > Report"]
---

# List reports

`GET /2/drive/{drive_id}/activities/reports`

List of activity reports.

## Path parameters

- `drive_id` integer, required

## Query parameters

- `with` string
- `users` integer[]
- `page` integer
- `per_page` integer
- `total` boolean
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 91ac10ffActivityReport[]
    - `id` integer, required — Activity report identifier
    - `status` 'done' | 'failed' | 'in_progress', required — Report status:</br> in_progress: Report generation still in progress</br> done: Report can be downloaded/exported</br> failed: Report generation failed
    - `size` string, required — Size in octet of the report
    - `generated_by` 91ac10ffAppUser, required
      - `id` integer, required — Unique identifier of the resource `App User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
      - `deleted_at` integer, nullable, required — Timestamp `App User` was deleted at
      - `teams` integer[] — List of Team identifiers
      - `security` object
        - `assistant_at` integer, nullable, required — The last date the assistant was used
        - `double_auth_method` string, required — Double authentication method used to log in
        - `has_double_auth` boolean, required — Whether the `App User` has double authentication enabled
        - `last_password_at` integer, nullable, required — Last time `App User`'s password was changed
        - `score` integer, required — Security score of the `App User`
        - `has_valid_email` integer, required — Whether the `App User` has a valid email
        - `has_recovery_email` boolean, required — Whether the `App User` has a recovery email
        - `has_valid_phone` boolean, required — Whether the `App User` has a valid phone number
    - `download_url` string, nullable, required — The download url of the report content
    - `created_at` integer, nullable, required — Timestamp `Activity Report` was created at
    - `updated_at` integer, nullable, required — Timestamp `Activity Report` was updated at
    - `filters` object — Filter used to generate the report
      - `actions` string[], required — Logged interaction type of activities on the drive or file.<note><strong>acl_insert</strong>: Technical: when a new group access to a file/directory is create.</note><note><strong>acl_main_users_insert</strong>: Logged when the main kDrive team access to a file/directory is created.</note><note><strong>acl_main_users_remove</strong>: Logged when the main kDrive team to a file/directory is removed.</note><note><strong>acl_main_users_update</strong>: Logged when the main kDrive team to a file/directory is modified.</note><note><strong>acl_remove</strong>: Technical: when a group access to a file/directory is removed.</note><note><strong>acl_team_insert</strong>: Logged when a team access to a file/directory is created.</note><note><strong>acl_team_remove</strong>: Logged when a team access to a file/directory is removed.</note><note><strong>acl_team_update</strong>: Logged when a team access to a file/directory is modified.</note><note><strong>acl_update</strong>: Technical: when a group access to a file/directory is modified.</note><note><strong>acl_user_insert</strong>: Logged when an user/admin access to a file/directory is created.</note><note><strong>acl_user_remove</strong>: Logged when an user/admin access to a file/directory is removed.</note><note><strong>acl_user_update</strong>: Logged when an user/admin access to a file/directory is modified.</note><note><strong>category_create</strong>: Logged when a new category is added.</note><note><strong>category_delete</strong>: Logged when a category is deleted.</note><note><strong>category_update</strong>: Logged when a category is renamed.</note><note><strong>collaborative_folder_access</strong>: Logged when an user/guest access to the dropbox.</note><note><strong>collaborative_folder_create</strong>: Logged when an user create a dropbox.</note><note><strong>collaborative_folder_delete</strong>: Logged when an user delete the dropbox.</note><note><strong>collaborative_folder_update</strong>: Logged when an user update settings of the dropbox.</note><note><strong>collaborative_user_access</strong>: Logged when an user/guest upload to the dropbox.</note><note><strong>collaborative_user_create</strong>: Logged when an user/guest add his information before uploading to the dropbox.</note><note><strong>collaborative_user_delete</strong>: Logged when an user remove the directory to the dropbox.</note><note><strong>comment_create</strong>: Logged when an user/admin add a comment on a file.</note><note><strong>comment_delete</strong>: Logged when an user/admin delete a comment on a file.</note><note><strong>comment_like</strong>: Logged when an user/admin like a comment on a file.</note><note><strong>comment_resolve</strong>: Logged when an user/admin resolve a comment on a file.</note><note><strong>comment_unlike</strong>: Logged when an user/admin unlike a comment on a file.</note><note><strong>comment_update</strong>: Logged when an user/admin update a comment on a file.</note><note><strong>exchange_pro_create</strong>: Technical: no used.</note><note><strong>file_access</strong>: Logged when an user/guest access to the file.</note><note><strong>file_categorize</strong>: Logged when a category is added to the file/directory.</note><note><strong>file_color_delete</strong>: Logged when a directory color is removed.</note><note><strong>file_color_update</strong>: Logged when a directory color changed.</note><note><strong>file_create</strong>: Logged when on the first file creation.</note><note><strong>file_delete</strong>: Logged when the file is deleted.</note><note><strong>file_favorite_create</strong>: Logged when a file/directory is flagged as favorites.</note><note><strong>file_favorite_remove</strong>: Logged when a file/directory is unflagged from favorites.</note><note><strong>file_ia_categorize</strong>: Logged when a file is categorized by the ia.</note><note><strong>file_move</strong>: Logged when the file is added inside a directory.</note><note><strong>file_move_out</strong>: Logged when the file is removed from a directory.</note><note><strong>file_rename</strong>: Logged when the file is renamed.</note><note><strong>file_rename_alias</strong>: Logged when a root file is renamed by an external user (only visible for the external user).</note><note><strong>file_restore</strong>: Logged when the file is restored from the trash.</note><note><strong>file_share_create</strong>: Logged when an external user access to a file/directory is created.</note><note><strong>file_share_delete</strong>: Logged when an external user access to a file/directory is removed.</note><note><strong>file_share_update</strong>: Logged when an external user access to a file/directory is modified to another permission.</note><note><strong>file_trash</strong>: Logged when the file is sent to trash.</note><note><strong>file_uncategorize</strong>: Logged when a category is removed to the file/directory.</note><note><strong>file_update</strong>: Logged when the file is updated.</note><note><strong>file_update_mime_type</strong>: Logged when a file mime_type is updated.</note><note><strong>maintenance_added</strong>: Logged when a maintenance start.</note><note><strong>maintenance_removed</strong>: Logged when a maintenance ends.</note><note><strong>rewind_ended</strong>: Logged when the user ended a rewind.</note><note><strong>rewind_started</strong>: Logged when the user started a rewind.</note><note><strong>share_link_create</strong>: Logged when a public share link to a file/directory is created.</note><note><strong>share_link_delete</strong>: Logged when a public share link to a file/directory is deleted.</note><note><strong>share_link_show</strong>: Logged when a public share link to a file/directory is seen by someone else.</note><note><strong>share_link_update</strong>: Logged when a public share link to a file/directory is modified.</note><note><strong>trash_empty</strong>: Logged when the user empties the trash.</note><note><strong>trash_empty_auto</strong>: Logged when the trash empties old files automatically.</note><note><strong>update_trash_settings</strong>: Logged when the user changes trash the settings.</note><note><strong>user_connected</strong>: Logged when an user is connected to the drive.</note><note><strong>user_create</strong>: Logged when an user/admin is added to the drive.</note><note><strong>user_delete</strong>: Logged when an user/admin has been removed of the drive.</note><note><strong>user_restore</strong>: Logged when an user/admin has been restored of the drive.</note><note><strong>user_update</strong>: Logged when an user/admin information has changed.</note>
      - `start_at` integer, nullable, required — Starting date of the report
      - `end_at` integer, nullable, required — Ending date of the report
      - `user` 91ac10ffAppUser, required
        - `id` integer, required — Unique identifier of the resource `App User`
        - `display_name` string, required — Display name
        - `first_name` string, required — First name
        - `last_name` string, required — Last name
        - `email` string, required — Email
        - `is_sso` boolean, required — returns true if the user is provided by an external IDP
        - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
        - `type` string
        - `deleted_at` integer, nullable, required — Timestamp `App User` was deleted at
        - `teams` integer[] — List of Team identifiers
        - `security` object
          - `assistant_at` integer, nullable, required — The last date the assistant was used
          - `double_auth_method` string, required — Double authentication method used to log in
          - `has_double_auth` boolean, required — Whether the `App User` has double authentication enabled
          - `last_password_at` integer, nullable, required — Last time `App User`'s password was changed
          - `score` integer, required — Security score of the `App User`
          - `has_valid_email` integer, required — Whether the `App User` has a valid email
          - `has_recovery_email` boolean, required — Whether the `App User` has a recovery email
          - `has_valid_phone` boolean, required — Whether the `App User` has a valid phone number
  - `total` integer — Total number of items Added when using query parameter `page`
  - `page` integer — Number of the current page Added when using query parameter `page`
  - `pages` integer — Total number of pages Added when using query parameter `page`
  - `items_per_page` integer — Number of items per page Added when using query parameter `page`

## Other responses

- `403` — Forbidden
- `503` — Service Unavailable

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)