Lists the aggregated activity of multiple users within the Gong system for each time period within the defined date range. This endpoint returns multiple records, one for each user. For each user there are items for every time period in the date range, including statistics about the user's activity. Records are returned only for users with activity in the range.
Required authorizaton scope: 'api:stats:user-actions'.
When paging is needed, provide the value supplied by the previous API call to bring the following page of records.
Filter parameters.
The date (in the company's time zone) from which to list a user's activity. This value is inclusive. The date should be specified in the following format: YYYY-MM-DD.
The date (in the company's time zone) until which to list a user's activity. This value is exclusive. This value should not exceed the current day. The date should be specified in the following format: YYYY-MM-DD.
Set of Gong's unique numeric identifiers for the users (up to 20 digits).
Calendar time period for aggregating data. Note: First day of the week is Monday.
Successful response
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Information about the number of records that match the requested filter.
Total number of records.
Number of records in the current page.
Current page number.
Returned only when there are more records to be retrieved. Repeat the API call and pass this cursor value in the request to retrieve the next page of records.
A list, in which each item contains details of one user's activities.
A list, in which each item contains details of one user's activities.
Gong's unique numeric identifier for the user (up to 20 digits).
The email address of the Gong user.
A list, in which each item contains aggregate user activity for consecutive time periods in the date range.
Aggregated activity for a user within a time period
The number of recorded calls this user hosted.
The number of recorded calls the user gave feedback on.
The number of recorded calls the user requested feedback on.
The number of recorded calls the user received feedback on.
The number of the user's own calls the user listened to.
The number of other users' calls the user listened to.
The number of calls the user shared with others inside the company.
The number of calls the user shared with others outside the company.
The number of scorecards the user completed.
The number of calls in which someone filled a scorecard on the user's calls.
The number of calls in which this user is participant (not host).
The number of calls in which a user gave at least one comment.
The number of calls in which a user received at least one comment on the users calls.
The number of calls in which someone pressed the "Mark as reviewed".
The number of calls in which someone pressed the “Mark as reviewed” on the users calls.
The start of the period, or the request filter's fromDate for the first period in the range, in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC.
The end of the period, or the request filter's toDate for the last period in the range, in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC.
Malformed request
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Access denied
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
User not found
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
API request limit exceeded
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Failed to complete the operation due to an unexpected error
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.