---
title: "Retrieve users daily activity by date"
slug: "retrieve-daily-activity-for-applicable-users-for-a-date-range-v2statsactivityday-by-day"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve daily activity for applicable users for a date range (/v2/stats/activity/day-by-day)

Post/v2/stats/activity/day-by-day

Retrieve the daily activity of multiple users within the Gong system for a range of dates. This endpoint returns records including statistics about each user's activity, on the daily level. Records are returned only for users with activity in the range.

Required authorizaton scope: 'api:stats:user-actions:detailed'.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='f8c39afe-524a-490c-91fc-3ea671e4ada0'>application/json</option>
</select>Expand Allobject  cursorstring    

When paging is needed, provide the value supplied by the previous API call to bring the following page of records.

ExampleeyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM
filterobject (MultipleUsersWithDates)  Required

Filter parameters.

fromDatestring    Required

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.

Example2019-01-20
toDatestring    Required

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.

Example2019-01-21
createdFromDateTimestring  (date-time)    
createdToDateTimestring  (date-time)    
userIds Array of string   

Set of Gong's unique numeric identifiers for the users (up to 20 digits).

Example[
  "234599484848423"
]string    

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='c67caf82-f6ae-473c-9d9a-8afbcb19c61d'>application/json</option>
</select>Expand Allobject  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
recordsobject (Records)  

Information about the number of records that match the requested filter.

totalRecordsinteger  (int32)    

Total number of records.

Example263
currentPageSizeinteger  (int32)    

Number of records in the current page.

Example100
currentPageNumberinteger  (int32)    

Current page number.

Example0
cursorstring    

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.

ExampleeyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM

usersDetailedActivities Array of object (UserDayByDayActivity)   

A list, in which each item contains one user's activity.

object  

A list, in which each item contains one user's activity.

userIdstring    

Gong's unique numeric identifier for the user (up to 20 digits).

userEmailAddressstring    

The email address of the Gong user.

userDailyActivityStats Array of object (DailyActivityWithDates)   

Array of daily activity records, one for every day in the date range.

object  

User daily activity

callsAsHost Array of string   

List of IDs of calls in which this user is the host.

Example[
  "348056639626337000"
]string    
callsGaveFeedback Array of string   

List of IDs of calls where the user gave feedback.

Example[
  "5580564522626337000"
]string    
callsRequestedFeedback Array of string   

List of IDs of calls where the user requested feedback.

Example[
  "342556337006"
]string    
callsReceivedFeedback Array of string   

List of IDs of calls where the user received feedback.

Example[
  "342556337006"
]string    
ownCallsListenedTo Array of string   

List of IDs of the user's own calls, that the user listened to.

Example[
  "4553256639626337000"
]string    
othersCallsListenedTo Array of string   

List of IDs of calls, not belonging to this user, that the user listened to.

Example[
  "56305663962633750"
]string    
callsSharedInternally Array of string   

List of IDs of calls the user shared with other users inside the company.

Example[
  "37555663966526330000"
]string    
callsSharedExternally Array of string   

List of IDs of calls the user shared with people outside the company.

Example[
  "4563962633756"
]string    
callsAttended Array of string   

List of IDs of calls in which this user is participant (not host)

Example[
  "45783962636582"
]string    
callsCommentsGiven Array of string   

List of IDs of calls in which a user gave at least one comment.

Example[
  "45663345636581"
]string    
callsCommentsReceived Array of string   

List of IDs of calls in which a user received at least one comment on the users calls.

Example[
  "45663962636582"
]string    
callsMarkedAsFeedbackGiven Array of string   

List of IDs of calls in which someone pressed the "Mark as reviewed".

Example[
  "45663962636581"
]string    
callsMarkedAsFeedbackReceived Array of string   

List of IDs of calls in which someone pressed the "Mark as reviewed" on the users calls.

Example[
  "45663388836581"
]string    
callsScorecardsFilled Array of string   

List of IDs of calls in which the user filled scorecards.

Example[
  "45663962636582"
]string    
callsScorecardsReceived Array of string   

List of IDs of calls in which someone filled a scorecard on the users calls.

Example[
  "45663962636581"
]string    
fromDatestring    

The start of the day 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.

Example2019-01-20T00:00:00-08:00
toDatestring    

The end of the day 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.

Example2019-01-21T000:00:00-08:00

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='d475ea02-80b2-4031-9638-686c482f5018'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='8b53b84d-d4b7-4039-91d8-86d5117b7a6d'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

404

User not found

<select class='api-response-data' aria-label='Media type'><option value='75862a50-931f-460c-987b-eaf671bd6468'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='b6aa9040-5253-4e12-b2d9-3147eeeca568'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='4bfefac0-db44-4ca1-a62b-d1a40a6c03e5'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string