> ## 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 Logs: Inputs, Cost & CLI Example
> Retrieve logs data by type and time range (/v2/logs). Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_list_logs:{"logType":"AccessLog","fromDateTime":"{{fromDateTime}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `payload.logType` | `"AccessLog" \| "UserActivityLog" \| "UserCallPlay" \| "ExternallySharedCallAccess" \| "ExternallySharedCallPlay"` | Yes | | Type of logs requested. |
| `payload.fromDateTime` | `string` | Yes | | The time from which to retrieve log records, in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC). |
| `payload.toDateTime` | `string` | No | | The time until which to retrieve log records, in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC); if not specified, the logs end with the latest recorded log. |
| `payload.cursor` | `string` | No | | When paging is needed, provide the value supplied by the previous API call to bring the following page of records. |
### Allowed values
| Field | Allowed values |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| `payload.logType` | `AccessLog`, `UserActivityLog`, `UserCallPlay`, `ExternallySharedCallAccess`, `ExternallySharedCallPlay` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "List log entries that took place during a specified time range. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:logs:read'.",
"properties": {
"logType": {
"type": "string",
"description": "Type of logs requested.",
"enum": [
"AccessLog",
"UserActivityLog",
"UserCallPlay",
"ExternallySharedCallAccess",
"ExternallySharedCallPlay"
]
},
"fromDateTime": {
"type": "string",
"description": "The time from which to retrieve log records, in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC)."
},
"toDateTime": {
"type": "string",
"description": "The time until which to retrieve log records, in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC); if not specified, the logs end with the latest recorded log."
},
"cursor": {
"type": "string",
"description": "When paging is needed, provide the value supplied by the previous API call to bring the following page of records."
}
},
"required": [
"logType",
"fromDateTime"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"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
},
"logEntries": {
"type": "array",
"description": "A list, in which each item specifies one log.",
"items": {
"type": "object",
"description": "A list, in which each item specifies one log.",
"properties": {
"userId": {
"type": "string",
"description": "Gong's unique numeric identifier for the user (up to 20 digits), if available."
},
"userEmailAddress": {
"type": "string",
"description": "The email address of the user, if available."
},
"userFullName": {
"type": "string",
"description": "The full name of the user, if available."
},
"impersonatorUserId": {
"type": "string",
"description": "Gong's unique numeric identifier for the impersonating user (up to 20 digits), if available."
},
"impersonatorEmailAddress": {
"type": "string",
"description": "The email address of the impersonating user, if available."
},
"impersonatorFullName": {
"type": "string",
"description": "The full name of the impersonating user, if available."
},
"impersonatorCompanyId": {
"type": "string",
"description": "Gong's unique numeric identifier for the impersonating user's company id (up to 20 digits), if available."
},
"eventTime": {
"type": "string",
"description": "The time in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC); when log was created."
},
"logRecord": {
"type": "object",
"description": "The list of log fields and associated values. This element will be populated dynamically by the log record, depending on the type of log.",
"additionalProperties": {
"type": "object",
"description": "The list of log fields and associated values. This element will be populated dynamically by the log record, depending on the type of log."
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute gong_list_logs --payload '{
"logType": "AccessLog",
"fromDateTime": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.