Required. The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectID}/locations/{location}, where {projectID} is the Google Cloud Platform project ID and {location} is a Cloud region.
For a list of supported locations, see Supported Regions. global is the default when unspecified.
Query parameters
Parameters
groupId
string
Required. The group for which events shall be returned. The groupId is 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, see Google Cloud Privacy Notice.
Optional. List only ErrorGroups which belong to a service context that matches the filter. Data for all service contexts is returned if this field is not specified.
Optional. List only data for the given time range. If not set a default time range is used. The field timeRangeBegin in the response will specify the beginning of this time range.
pageSize
integer
Optional. The maximum number of results to return per response.
pageToken
string
Optional. A nextPageToken provided by a previous response.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ListEventsResponse.
[[["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 lists error events for a specified Google Cloud Platform project and location, using the \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eprojectName\u003c/code\u003e path parameter, which is required, specifies the project and location (if not default \u003ccode\u003eglobal\u003c/code\u003e) where the error events are located.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egroupId\u003c/code\u003e query parameter is required and specifies which error group to retrieve events from, with its identifier being unique to each error group.\u003c/p\u003e\n"],["\u003cp\u003eThe optional query parameters like \u003ccode\u003eserviceFilter\u003c/code\u003e, \u003ccode\u003etimeRange\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e can be used to filter the events by service, time, or to limit or paginate the results, respectively.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, authorization is required via one of the provided OAuth scopes: \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.locations.events.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 events.\n\n### HTTP request\n\n`GET https://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*/locations/*}/events`\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 [ListEventsResponse](/error-reporting/reference/rest/v1beta1/ListEventsResponse).\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)."]]
