List all file versions
GET https://{{api.box.com}}/2.0/files/:file_id/versions
Retrieve a list of the past versions for a file.
https://developer.box.com/reference/get-files-id-versions
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
fields | string | 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. |
Be aware that specifying this parameter will have the
effect that none of the standard fields are returned in
the response unless explicitly specified, instead only
fields for the mini representation are returned, additional
to the fields requested. |
| limit
| number | | The maximum number of items to return per page. |
| offset
| number | | The offset of the item at which to begin the response.
Queries with offset parameter value exceeding 10000 will be rejected with a 400 response. |
RESPONSES
status: OK
{"total_count":5000,"limit":1000,"offset":2000,"order":[{"by":"type","direction":"ASC"}],"entries":[{"id":"12345","type":"file_version","sha1":"134b65991ed521fcfe4724b7d814ab8ded5185dc","name":"tigers.jpeg","size":629644,"created_at":"2012-12-12T10:53:43-08:00","modified_at":"2012-12-12T10:53:43-08:00","modified_by":{"id":"11446498","type":"user","name":"Aaron Levie","login":"ceo@example.com"},"trashed_at":"2012-12-12T10:53:43-08:00","trashed_by":{"id":"11446498","type":"user","name":"Aaron Levie","login":"ceo@example.com"},"restored_at":"2012-12-12T10:53:43-08:00","restored_by":{"id":"11446498","type":"user","name":"Aaron Levie","login":"ceo@example.com"},"purged_at":"2012-12-12T10:53:43-08:00","uploader_display_name":"Ellis Wiggins","version_number":"1"}]}