list

HTTP Request

GET /api/v1/datasets/:datasetReference/versions

Path parameters

Parameter

datasetReference

A qualified reference to the dataset. See referencing resources for more information.

Query parameters

Parameter

maxResults

Default 100. Must be less than 1000.

nextPageToken

For paginating through results, provide the value returned from the previous datasets.list call

This endpoint extends the general API structure.

Authorization

You must have overview access to the versions' dataset. If a dataset's overview is not public, your access token must have one of the following scopes:

  • data.overview

  • data.metadata

  • data.data

  • data.edit

In order to see unreleased versions, you must have edit access to the dataset, and you token must have the following scope:

  • data.edit

Learn more about authorization.

Request body

The request body must be empty.

Response body

Returns a JSON representation of an array of version.list resources.

{
"kind": "versionList",
"nextPageToken": integer,
"results": [
object(version.list)
]
}

Examples