Method: projects.models.versions.list

Stay organized with collections Save and categorize content based on your preferences.

Gets basic information about all the versions of a model.

If you expect that a model has many versions, or if you need to handle only a limited number of results at a time, you can request that the list be retrieved in batches (called pages).

If there are no versions that match the request parameters, the list request returns an empty response body: {}.

HTTP request

GET https://{endpoint}/v1/{parent=projects/*/models/*}/versions

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name of the model for which to list the version.

Authorization requires the following IAM permission on the specified resource parent:

  • ml.versions.list

Query parameters



Optional. Specifies the subset of versions to retrieve.



Optional. A page token to request the next page of results.

You get the token from the nextPageToken field of the response from the previous call.



Optional. The number of versions to retrieve per "page" of results. If there are more remaining results than this number, the response message will contain a valid value in the nextPageToken field.

The default value is 20, and the maximum page size is 100.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for the versions.list method.

JSON representation
  "versions": [
      object (Version)
  "nextPageToken": string

object (Version)

The list of versions.



Optional. Pass this token as the pageToken field of the request for a subsequent call.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.