> ## 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 Aggregate Activity
> Retrieve aggregated activity for defined users by date (/v2/stats/activity/aggregate). Includes inputs, outputs, SDK V2 examples, and Deepline cost.
Retrieve aggregated activity for defined users by date (/v2/stats/activity/aggregate).
> [!NOTE]
>
> Tool ID: `gong_list_multiple_users_aggregate_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_aggregate_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_aggregate_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
},
"usersAggregateActivityStats": [
{
"userId": "user_123",
"userEmailAddress": "jane.doe@example.com",
"userAggregateActivityStats": {
"callsAsHost": 123,
"callsGaveFeedback": 123,
"callsRequestedFeedback": 123
}
}
]
}
}
```
Use `deepline describe gong_list_multiple_users_aggregate_activity --json` for the latest machine-readable contract.
## Input reference
Lists the activity of multiple users within the Gong system during a defined period. Given the period, this endpoint returns multiple records, one for each user, with an applicable activity during the period. Each record includes statistics about the user's activity. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions'.
| 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": "Lists the activity of multiple users within the Gong system during a defined period. Given the period, this endpoint returns multiple records, one for each user, with an applicable activity during the period. Each record includes statistics about the user's activity. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:stats:user-actions'.",
"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.usersAggregateActivityStats` | `array` | No | — | A list, in which each item specifies one user's activities. |
| `result.data.usersAggregateActivityStats[].userId` | `string` | No | — | Gong's unique numeric identifier for the user (up to 20 digits). |
| `result.data.usersAggregateActivityStats[].userEmailAddress` | `string` | No | — | The email address of the Gong user. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats` | `object` | No | — | Aggregated activity for a user within a time period |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsAsHost` | `integer` | No | — | The number of recorded calls this user hosted. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsGaveFeedback` | `integer` | No | — | The number of recorded calls the user gave feedback on. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsRequestedFeedback` | `integer` | No | — | The number of recorded calls the user requested feedback on. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsReceivedFeedback` | `integer` | No | — | The number of recorded calls the user received feedback on. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.ownCallsListenedTo` | `integer` | No | — | The number of the user's own calls the user listened to. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.othersCallsListenedTo` | `integer` | No | — | The number of other users' calls the user listened to. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsSharedInternally` | `integer` | No | — | The number of calls the user shared with others inside the company. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsSharedExternally` | `integer` | No | — | The number of calls the user shared with others outside the company. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsScorecardsFilled` | `integer` | No | — | The number of scorecards the user completed. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsScorecardsReceived` | `integer` | No | — | The number of calls in which someone filled a scorecard on the user's calls. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsAttended` | `integer` | No | — | The number of calls in which this user is participant (not host). Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsCommentsGiven` | `integer` | No | — | The number of calls in which a user gave at least one comment. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsCommentsReceived` | `integer` | No | — | The number of calls in which a user received at least one comment on the users calls. Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsMarkedAsFeedbackGiven` | `integer` | No | — | The number of calls in which someone pressed the "Mark as reviewed". Format: `int32`. |
| `result.data.usersAggregateActivityStats[].userAggregateActivityStats.callsMarkedAsFeedbackReceived` | `integer` | No | — | The number of calls in which someone pressed the “Mark as reviewed” on the users calls. Format: `int32`. |
| `result.data.fromDateTime` | `string` | No | — | The date and time 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, when the list of results starts. |
| `result.data.toDateTime` | `string` | No | — | The date and time 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, when the list of results ends. |
| `result.data.timeZone` | `string` | No | — | The company's defined timezone in Gong. |
| `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
},
"usersAggregateActivityStats": {
"type": "array",
"description": "A list, in which each item specifies one user's activities.",
"items": {
"type": "object",
"description": "A list, in which each item specifies one user's activities.",
"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."
},
"userAggregateActivityStats": {
"type": "object",
"description": "Aggregated activity for a user within a time period",
"properties": {
"callsAsHost": {
"type": "integer",
"description": "The number of recorded calls this user hosted.",
"format": "int32"
},
"callsGaveFeedback": {
"type": "integer",
"description": "The number of recorded calls the user gave feedback on.",
"format": "int32"
},
"callsRequestedFeedback": {
"type": "integer",
"description": "The number of recorded calls the user requested feedback on.",
"format": "int32"
},
"callsReceivedFeedback": {
"type": "integer",
"description": "The number of recorded calls the user received feedback on.",
"format": "int32"
},
"ownCallsListenedTo": {
"type": "integer",
"description": "The number of the user's own calls the user listened to.",
"format": "int32"
},
"othersCallsListenedTo": {
"type": "integer",
"description": "The number of other users' calls the user listened to.",
"format": "int32"
},
"callsSharedInternally": {
"type": "integer",
"description": "The number of calls the user shared with others inside the company.",
"format": "int32"
},
"callsSharedExternally": {
"type": "integer",
"description": "The number of calls the user shared with others outside the company.",
"format": "int32"
},
"callsScorecardsFilled": {
"type": "integer",
"description": "The number of scorecards the user completed.",
"format": "int32"
},
"callsScorecardsReceived": {
"type": "integer",
"description": "The number of calls in which someone filled a scorecard on the user's calls.",
"format": "int32"
},
"callsAttended": {
"type": "integer",
"description": "The number of calls in which this user is participant (not host).",
"format": "int32"
},
"callsCommentsGiven": {
"type": "integer",
"description": "The number of calls in which a user gave at least one comment.",
"format": "int32"
},
"callsCommentsReceived": {
"type": "integer",
"description": "The number of calls in which a user received at least one comment on the users calls.",
"format": "int32"
},
"callsMarkedAsFeedbackGiven": {
"type": "integer",
"description": "The number of calls in which someone pressed the \"Mark as reviewed\".",
"format": "int32"
},
"callsMarkedAsFeedbackReceived": {
"type": "integer",
"description": "The number of calls in which someone pressed the “Mark as reviewed” on the users calls.",
"format": "int32"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"fromDateTime": {
"type": "string",
"description": "The date and time 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, when the list of results starts."
},
"toDateTime": {
"type": "string",
"description": "The date and time 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, when the list of results ends."
},
"timeZone": {
"type": "string",
"description": "The company's defined timezone in Gong."
}
},
"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.