> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Gong: List Multiple Users Day By Day Activity
> Retrieve daily activity for applicable users for a date range (/v2/stats/activity/day-by-day). Includes inputs, outputs, SDK V2 examples, and Deepline cost.
Retrieve daily activity for applicable users for a date range (/v2/stats/activity/day-by-day).
> [!NOTE]
>
> Tool ID: `gong_list_multiple_users_day_by_day_activity`
## Run this action
Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.
```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'gong_list_multiple_users_day_by_day_activity',
{
"filter": {
"fromDate": "2026-01-15T12:00:00Z",
"toDate": "2026-01-15T12:00:00Z"
}
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_list_multiple_users_day_by_day_activity --input '{
"filter": {
"fromDate": "2026-01-15T12:00:00Z",
"toDate": "2026-01-15T12:00:00Z"
}
}' --json
```
## Example response
The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"data": {
"requestId": "request_123",
"records": {
"totalRecords": 123,
"currentPageSize": 123,
"currentPageNumber": 123
},
"usersDetailedActivities": [
{
"userId": "user_123",
"userEmailAddress": "jane.doe@example.com",
"userDailyActivityStats": [
{}
]
}
]
}
}
```
Use `deepline describe gong_list_multiple_users_day_by_day_activity --json` for the latest machine-readable contract.
## Input reference
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. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions:detailed'.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.cursor` | `string` | No | — | When paging is needed, provide the value supplied by the previous API call to bring the following page of records. |
| `payload.filter` | `object` | Yes | — | Filter parameters. |
Show raw input schema
### Input JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"description": "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. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions:detailed'.",
"properties": {
"cursor": {
"type": "string",
"description": "When paging is needed, provide the value supplied by the previous API call to bring the following page of records."
},
"filter": {
"type": "object",
"description": "Filter parameters.",
"properties": {
"fromDate": {
"type": "string",
"description": "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."
},
"toDate": {
"type": "string",
"description": "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."
},
"createdFromDateTime": {
"type": "string",
"format": "date-time"
},
"createdToDateTime": {
"type": "string",
"format": "date-time"
},
"userIds": {
"type": "array",
"description": "Set of Gong's unique numeric identifiers for the users (up to 20 digits).",
"uniqueItems": true,
"items": {
"type": "string"
}
}
},
"required": [
"fromDate",
"toDate"
],
"additionalProperties": false
}
},
"required": [
"filter"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.requestId` | `string` | No | — | A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes. |
| `result.data.records` | `object` | No | — | Information about the number of records that match the requested filter. |
| `result.data.records.totalRecords` | `integer` | No | — | Total number of records. Format: `int32`. |
| `result.data.records.currentPageSize` | `integer` | No | — | Number of records in the current page. Format: `int32`. |
| `result.data.records.currentPageNumber` | `integer` | No | — | Current page number. Format: `int32`. |
| `result.data.records.cursor` | `string` | No | — | 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. |
| `result.data.usersDetailedActivities` | `array` | No | — | A list, in which each item contains one user's activity. |
| `result.data.usersDetailedActivities[].userId` | `string` | No | — | Gong's unique numeric identifier for the user (up to 20 digits). |
| `result.data.usersDetailedActivities[].userEmailAddress` | `string` | No | — | The email address of the Gong user. |
| `result.data.usersDetailedActivities[].userDailyActivityStats` | `array` | No | — | Array of daily activity records, one for every day in the date range. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsAsHost` | `array` | No | — | List of IDs of calls in which this user is the host. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsGaveFeedback` | `array` | No | — | List of IDs of calls where the user gave feedback. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsRequestedFeedback` | `array` | No | — | List of IDs of calls where the user requested feedback. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsReceivedFeedback` | `array` | No | — | List of IDs of calls where the user received feedback. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].ownCallsListenedTo` | `array` | No | — | List of IDs of the user's own calls, that the user listened to. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].othersCallsListenedTo` | `array` | No | — | List of IDs of calls, not belonging to this user, that the user listened to. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsSharedInternally` | `array` | No | — | List of IDs of calls the user shared with other users inside the company. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsSharedExternally` | `array` | No | — | List of IDs of calls the user shared with people outside the company. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsAttended` | `array` | No | — | List of IDs of calls in which this user is participant (not host) |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsCommentsGiven` | `array` | No | — | List of IDs of calls in which a user gave at least one comment. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsCommentsReceived` | `array` | No | — | List of IDs of calls in which a user received at least one comment on the users calls. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsMarkedAsFeedbackGiven` | `array` | No | — | List of IDs of calls in which someone pressed the "Mark as reviewed". |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsMarkedAsFeedbackReceived` | `array` | No | — | List of IDs of calls in which someone pressed the "Mark as reviewed" on the users calls. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsScorecardsFilled` | `array` | No | — | List of IDs of calls in which the user filled scorecards. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].callsScorecardsReceived` | `array` | No | — | List of IDs of calls in which someone filled a scorecard on the users calls. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].fromDate` | `string` | No | — | 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. |
| `result.data.usersDetailedActivities[].userDailyActivityStats[].toDate` | `string` | No | — | 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. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"requestId": {
"type": "string",
"description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
},
"records": {
"type": "object",
"description": "Information about the number of records that match the requested filter.",
"properties": {
"totalRecords": {
"type": "integer",
"description": "Total number of records.",
"format": "int32"
},
"currentPageSize": {
"type": "integer",
"description": "Number of records in the current page.",
"format": "int32"
},
"currentPageNumber": {
"type": "integer",
"description": "Current page number.",
"format": "int32"
},
"cursor": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
},
"usersDetailedActivities": {
"type": "array",
"description": "A list, in which each item contains one user's activity.",
"items": {
"type": "object",
"description": "A list, in which each item contains one user's activity.",
"properties": {
"userId": {
"type": "string",
"description": "Gong's unique numeric identifier for the user (up to 20 digits)."
},
"userEmailAddress": {
"type": "string",
"description": "The email address of the Gong user."
},
"userDailyActivityStats": {
"type": "array",
"description": "Array of daily activity records, one for every day in the date range.",
"items": {
"type": "object",
"description": "User daily activity",
"properties": {
"callsAsHost": {
"type": "array",
"description": "List of IDs of calls in which this user is the host.",
"items": {
"type": "string"
}
},
"callsGaveFeedback": {
"type": "array",
"description": "List of IDs of calls where the user gave feedback.",
"items": {
"type": "string"
}
},
"callsRequestedFeedback": {
"type": "array",
"description": "List of IDs of calls where the user requested feedback.",
"items": {
"type": "string"
}
},
"callsReceivedFeedback": {
"type": "array",
"description": "List of IDs of calls where the user received feedback.",
"items": {
"type": "string"
}
},
"ownCallsListenedTo": {
"type": "array",
"description": "List of IDs of the user's own calls, that the user listened to.",
"items": {
"type": "string"
}
},
"othersCallsListenedTo": {
"type": "array",
"description": "List of IDs of calls, not belonging to this user, that the user listened to.",
"items": {
"type": "string"
}
},
"callsSharedInternally": {
"type": "array",
"description": "List of IDs of calls the user shared with other users inside the company.",
"items": {
"type": "string"
}
},
"callsSharedExternally": {
"type": "array",
"description": "List of IDs of calls the user shared with people outside the company.",
"items": {
"type": "string"
}
},
"callsAttended": {
"type": "array",
"description": "List of IDs of calls in which this user is participant (not host)",
"items": {
"type": "string"
}
},
"callsCommentsGiven": {
"type": "array",
"description": "List of IDs of calls in which a user gave at least one comment.",
"items": {
"type": "string"
}
},
"callsCommentsReceived": {
"type": "array",
"description": "List of IDs of calls in which a user received at least one comment on the users calls.",
"items": {
"type": "string"
}
},
"callsMarkedAsFeedbackGiven": {
"type": "array",
"description": "List of IDs of calls in which someone pressed the \"Mark as reviewed\".",
"items": {
"type": "string"
}
},
"callsMarkedAsFeedbackReceived": {
"type": "array",
"description": "List of IDs of calls in which someone pressed the \"Mark as reviewed\" on the users calls.",
"items": {
"type": "string"
}
},
"callsScorecardsFilled": {
"type": "array",
"description": "List of IDs of calls in which the user filled scorecards.",
"items": {
"type": "string"
}
},
"callsScorecardsReceived": {
"type": "array",
"description": "List of IDs of calls in which someone filled a scorecard on the users calls.",
"items": {
"type": "string"
}
},
"fromDate": {
"type": "string",
"description": "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."
},
"toDate": {
"type": "string",
"description": "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."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Deepline cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
## Related documentation
* [Gong provider guide](https://deepline.com/docs/providers/gong/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.