> ## 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 Calls Extensive > Retrieve detailed call data by various filters (/v2/calls/extensive). Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost. Retrieve detailed call data by various filters (/v2/calls/extensive). > [!NOTE] > > Tool ID: `gong_list_calls_extensive` ## 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_calls_extensive', { "filter": { "fromDateTime": "2026-01-15T12:00:00Z", "toDateTime": "2026-01-15T12:00:00Z", "workspaceId": "workspace_123" } }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} deepline tools execute gong_list_calls_extensive --input '{ "filter": { "fromDateTime": "2026-01-15T12:00:00Z", "toDateTime": "2026-01-15T12:00:00Z", "workspaceId": "workspace_123" } }' --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 }, "calls": [ { "metaData": { "id": "id_123", "url": "https://example.com", "title": "VP of Engineering" }, "context": [ {} ], "parties": [ {} ] } ] } } ``` Use `deepline describe gong_list_calls_extensive --json` for the latest machine-readable contract. ## Input reference Lists detailed call data for calls that took place during a specified date range, have specified call IDs or hosted by specified users. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:extensive'. Moreover, clients requesting media download URLs by the contentSelector.exposedFields.media field should also have the scope 'api:calls:read:media-url'. | 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. | | `payload.contentSelector` | `object` | No | — | The content selector identifies which data components, if any, are needed, by the caller |
Show raw input schema ### Input JSON Schema ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}} { "type": "object", "description": "Lists detailed call data for calls that took place during a specified date range, have specified call IDs or hosted by specified users. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:extensive'. Moreover, clients requesting media download URLs by the contentSelector.exposedFields.media field should also have the scope 'api:calls:read:media-url'.", "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": { "fromDateTime": { "type": "string", "description": "Date and time (in ISO-8601 format: '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC) from which to list recorded calls. Returns calls that started on or after the specified date and time. If not provided, list starts with earliest call. The date applies to call start time." }, "toDateTime": { "type": "string", "description": "Date and time (in ISO-8601 format: '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC) until which to list recorded calls. Returns calls that started up to but excluding specified date and time. If not provided, list ends with most recent call. The date applies to call start time." }, "workspaceId": { "type": "string", "description": "Optional Workspace identifier, if supplied the API will return only the calls belonging to this workspace." }, "callIds": { "type": "array", "description": "List of calls Ids to be filtered. If not supplied, returns all calls between fromDateTime and toDateTime.", "uniqueItems": true, "items": { "type": "string" } }, "primaryUserIds": { "type": "array", "description": "An optional list of user identifiers, if supplied the API will return only the calls hosted by the specified users. The identifiers in this field match the primaryUserId field of the calls.", "uniqueItems": true, "items": { "type": "string" } } }, "additionalProperties": false }, "contentSelector": { "type": "object", "description": "The content selector identifies which data components, if any, are needed, by the caller", "properties": { "context": { "type": "string", "description": "If 'Basic', add links to external systems (context objects) such as CRM, Telephony System, Case Management. If 'Extended' include also data (context fields) for these links. Default value 'None'", "enum": [ "None", "Basic", "Extended" ] }, "contextTiming": { "type": "array", "description": "Timing for the context data. The field is optional and can contain either \"Now\" or \"TimeOfCall\" or both. The default value is [\"Now\"]. Can be provided only when the context field is set to 'Extended'", "items": { "type": "string", "description": "Timing for the context data. The field is optional and can contain either \"Now\" or \"TimeOfCall\" or both. The default value is [\"Now\"]. Can be provided only when the context field is set to 'Extended'", "enum": [ "Now", "TimeOfCall" ] } }, "exposedFields": { "type": "object", "description": "The exposed fields identifies which field, if any, are returned in the response object", "properties": { "parties": { "type": "boolean", "description": "If true, add information about the parties of the call" }, "content": { "type": "object", "description": "The content of the call", "properties": { "structure": { "type": "boolean", "description": "If true, add call agenda, if available" }, "topics": { "type": "boolean", "description": "If true, add duration of call topics" }, "trackers": { "type": "boolean", "description": "If true, returns smart tracker and keyword tracker information for the call." }, "trackerOccurrences": { "type": "boolean", "description": "If true, the API will return the timing and speaker ID of each occurrence of a tracker (in addition to other tracker data). This functionality must be used in combination with the \"trackers\" field. The occurrence data is available only for the calls recorded since Jan 1, 2023, contact Gong support if a backfill of this data is required." }, "pointsOfInterest": { "type": "boolean", "description": "deprecated." }, "brief": { "type": "boolean", "description": "When true, returns the spotlight call brief." }, "outline": { "type": "boolean", "description": "When true, returns the call outline." }, "highlights": { "type": "boolean", "description": "When true, returns the call highlights." }, "callOutcome": { "type": "boolean", "description": "When true, returns the outcome of the call." }, "keyPoints": { "type": "boolean", "description": "When true, returns the key points of the call." } }, "additionalProperties": false }, "interaction": { "type": "object", "description": "The interaction data of the call", "properties": { "speakers": { "type": "boolean", "description": "If true, add the time each participant spoke." }, "video": { "type": "boolean", "description": "If true, add video statistics" }, "personInteractionStats": { "type": "boolean", "description": "If true, add statistics for the host of the call." }, "questions": { "type": "boolean", "description": "If true, add question counts" } }, "additionalProperties": false }, "collaboration": { "type": "object", "description": "Call collaboration", "properties": { "publicComments": { "type": "boolean", "description": "If true, add public comments made for this call" } }, "additionalProperties": false }, "media": { "type": "boolean", "description": "If true and exist, add audio url and video url of the call. The urls will be available for 8 hours." } }, "additionalProperties": false } }, "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.calls` | `array` | No | — | A list with one entry per call. | | `result.data.calls[].metaData` | `object` | No | — | call's metadata. | | `result.data.calls[].metaData.id` | `string` | No | — | Gong's unique numeric identifier for the call (up to 20 digits). | | `result.data.calls[].metaData.url` | `string` | No | — | The URL to the page in the Gong web application where the call is available. | | `result.data.calls[].metaData.title` | `string` | No | — | The title of the call. | | `result.data.calls[].metaData.scheduled` | `string` | No | — | Scheduled date and time of the call 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). Format: `date-time`. | | `result.data.calls[].metaData.started` | `string` | No | — | The date and time when the call was recorded 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). Format: `date-time`. | | `result.data.calls[].metaData.duration` | `integer` | No | — | The duration of the call, in seconds. Format: `int64`. | | `result.data.calls[].metaData.primaryUserId` | `string` | No | — | The primary user ID of the team member who hosted the call. | | `result.data.calls[].metaData.direction` | `"Inbound" \| "Outbound" \| "Conference" \| "Unknown"` | No | — | Call direction. Allowed: `Inbound`, `Outbound`, `Conference`, `Unknown`. | | `result.data.calls[].metaData.system` | `string` | No | — | The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.). | | `result.data.calls[].metaData.scope` | `"Internal" \| "External" \| "Unknown"` | No | — | The scope of the call: 'internal' if all the participants are from the company, 'external' if some participants are not from the company, or 'unknown' if the scope is unknown. Allowed: `Internal`, `External`, `Unknown`. | | `result.data.calls[].metaData.media` | `"Video" \| "Audio"` | No | — | Media type Allowed: `Video`, `Audio`. | | `result.data.calls[].metaData.language` | `string` | No | — | The language codes (as defined by ISO-639-2B). E.g., eng, fre, spa, ger, and ita. Also used are und (unsupported language), and zxx (not enough speech content for identification). | | `result.data.calls[].metaData.workspaceId` | `string` | No | — | Gong's unique numeric identifier for the call's workspace (up to 20 digits). | | `result.data.calls[].metaData.sdrDisposition` | `string` | No | — | The SDR disposition of the call. This can be an automated value provided by the provider, or manually entered by the rep. | | `result.data.calls[].metaData.clientUniqueId` | `string` | No | — | The call's unique identifier in the origin recording system (typically a telephony recording system). The identifier is provided to Gong during the call creation via the Public API or through telephony systems integrations. | | `result.data.calls[].metaData.customData` | `string` | No | — | Metadata as was provided to Gong during the call creation via the Public API. | | `result.data.calls[].metaData.purpose` | `string` | No | — | The purpose of the call. | | `result.data.calls[].metaData.meetingUrl` | `string` | No | — | The meeting provider URL on which the web conference was recorded. | | `result.data.calls[].metaData.isPrivate` | `boolean` | No | — | If the call is private. | | `result.data.calls[].metaData.calendarEventId` | `string` | No | — | The Id of the meeting in Google or Outlook Calendar. | | `result.data.calls[].context` | `array` | No | — | A list of the agenda of each part of the call. | | `result.data.calls[].context[].system` | `"Salesforce" \| "HubSpot" \| "MicrosoftDynamic" \| "Generic"` | No | — | External system name. e.g. Salesforce Allowed: `Salesforce`, `HubSpot`, `MicrosoftDynamic`, `Generic`. | | `result.data.calls[].context[].objects` | `array` | No | — | List of objects within the external system | | `result.data.calls[].context[].objects[].objectType` | `"Opportunity" \| "Account"` | No | — | Object Type. e.g Opportunity. Allowed: `Opportunity`, `Account`. | | `result.data.calls[].context[].objects[].objectId` | `string` | No | — | Object ID | | `result.data.calls[].context[].objects[].fields` | `array` | No | — | — | | `result.data.calls[].context[].objects[].fields[].name` | `string` | No | — | Field name. For Account supported fields are: Name, Website, Industry and all the custom fields. For Opportunity supported fields are Name, LeadSource, Type, StageName, Probability, Amount, CloseDate and all the custom fields. | | `result.data.calls[].context[].objects[].fields[].value` | `record` | No | — | Field value | | `result.data.calls[].context[].objects[].timing` | `"Now" \| "TimeOfCall"` | No | — | Timing of object Allowed: `Now`, `TimeOfCall`. | | `result.data.calls[].parties` | `array` | No | — | A list of the call's participants | | `result.data.calls[].parties[].id` | `string` | No | — | Unique ID of the participant in the call. | | `result.data.calls[].parties[].emailAddress` | `string` | No | — | Email address. | | `result.data.calls[].parties[].name` | `string` | No | — | The name of the participant. | | `result.data.calls[].parties[].title` | `string` | No | — | The job title of the participant | | `result.data.calls[].parties[].userId` | `string` | No | — | The user ID of the participant within the Gong system, if the participant exists in the system. | | `result.data.calls[].parties[].speakerId` | `string` | No | — | Unique ID of a participant that spoke in the call. References to this id will appear in the '/v2/calls/transcript' endpoint response. | | `result.data.calls[].parties[].context` | `array` | No | — | A list of links to external systems such as CRM, Dialer, Case Management, etc. | | `result.data.calls[].parties[].context[].system` | `"Salesforce" \| "HubSpot" \| "MicrosoftDynamic" \| "Generic"` | No | — | External system name. e.g. Salesforce Allowed: `Salesforce`, `HubSpot`, `MicrosoftDynamic`, `Generic`. | | `result.data.calls[].parties[].context[].objects` | `array` | No | — | List of objects within the external system | | `result.data.calls[].parties[].context[].objects[].objectType` | `"Contact" \| "User" \| "Lead"` | No | — | Object Type. e.g. Lead Allowed: `Contact`, `User`, `Lead`. | | `result.data.calls[].parties[].context[].objects[].objectId` | `string` | No | — | Object ID | The table shows the first 50 fields. Use the live contract below for every field. > [!NOTE] > > This output schema is too large for an inline display. Read the complete live contract with `deepline describe gong_list_calls_extensive --json`. ## 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.