Required. The resource name of the Google Cloud Platform project. Written asprojects/{projectID}orprojects/{projectNumber}, where{projectID}and{projectNumber}can be found in theGoogle Cloud console. It may also include a location, such asprojects/{projectID}/locations/{location}where{location}is a cloud region.
For a list of supported locations, seeSupported Regions.globalis the default when unspecified. Use-as a wildcard to request group stats from all regions.
Query parameters
Parameters
groupId[]
string
Optional. List allErrorGroupStatswith these IDs. ThegroupIdis a unique identifier for a particular error group. The identifier is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, seeGoogle Cloud Privacy Notice.
Optional. List onlyErrorGroupStatswhich belong to a service context that matches the filter. Data for all service contexts is returned if this field is not specified.
Optional. List data for the given time range. If not set, a default time range is used. The fieldtimeRangeBeginin the response will specify the beginning of this time range. OnlyErrorGroupStatswith a non-zero count in the given time range are returned, unless the request contains an explicitgroupIdlist. If agroupIdlist is given, alsoErrorGroupStatswith zero occurrences are returned.
Optional. Time where the timed counts shall be aligned if rounded alignment is chosen. Default is 00:00 UTC.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z"or"2014-10-02T15:01:23+05:30".
Optional. The sort order in which the results are returned. Default isCOUNT_DESC.
pageSize
integer
Optional. The maximum number of results to return per response. Default is 20.
pageToken
string
Optional. AnextPageTokenprovided by a previous response. To view additional results, pass this token along with the identical query parameters as the first request.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eThis endpoint retrieves error group statistics from a specified Google Cloud project, with the project name being a required path parameter.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the error statistics by \u003ccode\u003egroupId\u003c/code\u003e, \u003ccode\u003eserviceFilter\u003c/code\u003e, and \u003ccode\u003etimeRange\u003c/code\u003e, as well as specify the preferred duration for timed counts and their alignment with optional query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request does not require a body, and the response, if successful, will be in the format of \u003ccode\u003eListGroupStatsResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request supports options for sorting results (\u003ccode\u003eorder\u003c/code\u003e), controlling the number of results per response (\u003ccode\u003epageSize\u003c/code\u003e), and using a \u003ccode\u003epageToken\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eTo use this endpoint, the request must be authenticated with either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/stackdriver-integration\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.groupStats.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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the specified groups.\n\n### HTTP request\n\n`GET https://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*/locations/*}/groupStats`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListGroupStatsResponse](/error-reporting/reference/rest/v1beta1/ListGroupStatsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/stackdriver-integration`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
