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

Preview this Workflow on desktop