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": "[e-mail]",                "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": "[e-mail]",                "name": "Aaron Levie",                "type": "user"            },            "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",            "size": 629644,            "trashed_at": "2012-12-12T10:53:43-08:00",            "trashed_by": {                "id": "11446498",                "login": "[e-mail]",                "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

Preview this Workflow on desktop