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

ParameterDescription
File IDThe unique identifier that represents a file.

​
Advanced Parameters

ParameterDescription
FieldsA 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.
LimitThe maximum number of items to return per page.
OffsetThe 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
Workflow LibraryPreview this Workflow on desktop