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

Preview this Workflow on desktop