Method: revisions.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists a file's revisions.
HTTP request
GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
fileId |
string
The ID of the file.
|
Query parameters
| Parameters |
maxResults |
integer
Maximum number of revisions to return.
|
pageToken |
string
Page token for revisions. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.
|
Request body
The request body must be empty.
Response body
A list of revisions of a file.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"items": [
{
object (Revision)
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string
} |
| Fields |
items[] |
object (Revision)
The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
|
nextPageToken |
string
The page token for the next page of revisions. This field will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded and pagination should be restarted from the first page of results.
|
kind |
string
This is always drive#revisionList.
|
etag |
string
The ETag of the list.
|
selfLink |
string
A link back to this list.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-23 UTC.
[null,null,["Last updated 2025-07-23 UTC."],[],[],null,["# Method: revisions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RevisionList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a file's revisions.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of revisions to return. |\n| `pageToken` | `string` Page token for revisions. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of revisions of a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"items\": [ { object (/workspace/drive/api/reference/rest/v2/revisions#Revision) } ], \"nextPageToken\": string, \"kind\": string, \"etag\": string, \"selfLink\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[Revision](/workspace/drive/api/reference/rest/v2/revisions#Revision)`)` The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `nextPageToken` | `string` The page token for the next page of revisions. This field will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded and pagination should be restarted from the first page of results. |\n| `kind` | `string` This is always `drive#revisionList`. |\n| `etag` | `string` The ETag of the list. |\n| `selfLink` | `string` A link back to this list. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
