Get a ListItemVersion resource

Retrieve the metadata for a specific version of a ListItem.

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	Sites.Read.All, Sites.ReadWrite.All
Delegated (personal Microsoft account)	n/a
Application	Sites.Read.All, Sites.ReadWrite.All

HTTP request

GET /sites/{site-id}/items/{item-id}/versions/{version-id}
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/versions/{version-id}

Response

If successful, this method returns a 200 OK response code and a ListItemVersion object in the response body.

Example

This example retrieves a version of a listItem and expands the fields collection to request the values of fields in the listItem.

HTTP request

GET /sites/{site-id}/lists/{list-id}/items/{item-id}/versions/{version-id}?expand=fields

Response

This returns a collection of versions:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "1.0",
    "lastModifiedBy": {
    "user": {
        "id": "CE251278-EF9E-4FE5-833C-1D89EEAE68E0",
        "displayName": "Ryan Gregg"
    }
    },
    "lastModifiedDateTime": "2017-09-14T12:34:53.912Z",
    "fields": {  }
}