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 page details how to retrieve error group statistics using an HTTP GET request to the Google Cloud Error Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eprojectName\u003c/code\u003e path parameter, which specifies the Google Cloud project and may optionally include a location.\u003c/p\u003e\n"],["\u003cp\u003eSeveral optional query parameters can be used to filter and customize the results, including \u003ccode\u003egroupId[]\u003c/code\u003e, \u003ccode\u003eserviceFilter\u003c/code\u003e, \u003ccode\u003etimeRange\u003c/code\u003e, and parameters for timed counts, as well as controls for sorting, pagesize and additional page results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response body, if successful, will be a \u003ccode\u003eListGroupStatsResponse\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eTo authorize the request, one of two OAuth scopes is required: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/stackdriver-integration\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.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/*}/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)."]]
