> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All File Versions

Retrieve a list of the past versions for a file.

Versions are only tracked by Box users with premium accounts. To fetch the ID
of the current version of a file, use the `GET /file/:id` API.

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                   |
  | --------- | --------------------------------------------- |
  | File ID   | The unique identifier that represents a file. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                |
  | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Fields    | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. |
  | Limit     | The maximum number of items to return per page.                                                                                                            |
  | Offset    | The offset of the item at which to begin the response.                                                                                                     |
</div>

## Example Output

```json theme={"dark"}
{
	"entries": [
		{
			"created_at": "2012-12-12T10:53:43-08:00",
			"id": "12345",
			"modified_at": "2012-12-12T10:53:43-08:00",
			"modified_by": {
				"id": "11446498",
				"login": "ceo@example.com",
				"name": "Aaron Levie",
				"type": "user"
			},
			"name": "tigers.jpeg",
			"purged_at": "2012-12-12T10:53:43-08:00",
			"restored_at": "2012-12-12T10:53:43-08:00",
			"restored_by": {
				"id": "11446498",
				"login": "ceo@example.com",
				"name": "Aaron Levie",
				"type": "user"
			},
			"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
			"size": 629644,
			"trashed_at": "2012-12-12T10:53:43-08:00",
			"trashed_by": {
				"id": "11446498",
				"login": "ceo@example.com",
				"name": "Aaron Levie",
				"type": "user"
			},
			"type": "file_version",
			"uploader_display_name": "Ellis Wiggins"
		}
	],
	"limit": 1000,
	"offset": 2000,
	"order": [
		{
			"by": "type",
			"direction": "ASC"
		}
	],
	"total_count": 5000
}
```

## Workflow Library Example

[Get All File Versions with Box and Send Results Via Email](https://library.blinkops.com/workflows/get-all-file-versions-with-box-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-all-file-versions-with-box-and-send-results-via-email/canvas" />
</div>