Version Headers: list

Requires authorization

Lists all Container Versions of a GTM Container. Try it now.


HTTP request



Parameter name Value Description
Path parameters
parent string GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}
Optional query parameters
includeDeleted boolean Also retrieve deleted (archived) versions when true.
pageToken string Continuation token for fetching the next page of results.


This request requires authorization with at least one of the following scopes (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "containerVersionHeader": [
      "path": string,
      "accountId": string,
      "containerId": string,
      "containerVersionId": string,
      "name": string,
      "numMacros": string,
      "numRules": string,
      "numTags": string,
      "numTriggers": string,
      "deleted": boolean,
      "numVariables": string,
      "numZones": string
  "nextPageToken": string
Property name Value Description Notes
containerVersionHeader[] list All container version headers of a GTM Container.
containerVersionHeader[].path string GTM Container Versions's API relative path.
containerVersionHeader[].accountId string GTM Account ID.
containerVersionHeader[].containerId string GTM Container ID.
containerVersionHeader[].containerVersionId string The Container Version ID uniquely identifies the GTM Container Version.
containerVersionHeader[].name string Container version display name.
containerVersionHeader[].numMacros string Number of macros in the container version.
containerVersionHeader[].numRules string Number of rules in the container version.
containerVersionHeader[].numTags string Number of tags in the container version.
containerVersionHeader[].numTriggers string Number of triggers in the container version.
containerVersionHeader[].deleted boolean A value of true indicates this container version has been deleted.
containerVersionHeader[].numVariables string Number of variables in the container version.
nextPageToken string Continuation token for fetching the next page of results.
containerVersionHeader[].numZones string Number of zones in the container version.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.