---
title: "List"
method: GET
path: "/3/drive/{drive_id}/files/{file_id}/versions"
tags: ["Drive > Files > File/Directory > Version"]
---

# List

`GET /3/drive/{drive_id}/files/{file_id}/versions`

Get list of file versions

## Path parameters

- `drive_id` integer, required
- `file_id` integer, required

## Query parameters

- `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` 91ac10ffFileVersion[]
    - `id` integer, required — Unique identifier of the resource `File Version`
    - `keep_forever` boolean, required — Keep the resource `File Version` forever, otherwise will be delete in 120 days
    - `mime_type` string, nullable, required — Mime type of the resource `File Version`
    - `extension_type` 'archive' | 'audio' | 'code' | 'diagram' | 'dir' | 'email' | 'font' | 'form' | 'image' | 'model' | 'pdf' | 'presentation' | 'spreadsheet' | 'text' | 'unknown' | 'video', required — Generic file types, matching a known set of extensions and/or mime types.<note><strong>archive</strong>: Archive file.</note><note><strong>audio</strong>: Audio only file.</note><note><strong>code</strong>: Text file recognized as code.</note><note><strong>diagram</strong>: Diagram file.</note><note><strong>dir</strong>: Directory.</note><note><strong>email</strong>: Bundled email file.</note><note><strong>font</strong>: Text file recognized as font.</note><note><strong>form</strong>: Form file.</note><note><strong>image</strong>: Image file.</note><note><strong>model</strong>: 3D file.</note><note><strong>pdf</strong>: PDF file.</note><note><strong>presentation</strong>: Presentation/slides file.</note><note><strong>spreadsheet</strong>: Spreadsheet file.</note><note><strong>text</strong>: Generic text file.</note><note><strong>unknown</strong>: Generic file, not recognized as any of the other type.</note><note><strong>video</strong>: Video file; may contain other stream types such as audio or subtitles.</note>
    - `size` integer, required — Size of the resource `File Version`
    - `updated_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
    - `created_at` integer, required — Timestamp `File Version` was created at
    - `updated_at` integer, nullable, required — Timestamp `File Version` was updated at
    - `last_modified_at` integer, nullable, required — The last modified date of the file version, null if unknown
  - `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)