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
Parameter | Description |
---|---|
File ID | The unique identifier that represents a file. |
Advanced Parameters
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. |
Example Output
{
"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