> ## 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

> Retrieve call data by date range (/v2/calls). Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Retrieve call data by date range (/v2/calls).

> [!NOTE]
>
> Tool ID: `gong_list_calls`

## 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',
  {
    "fromDateTime": "2026-01-15T12:00:00Z",
    "toDateTime": "2026-01-15T12:00:00Z"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_list_calls --input '{
  "fromDateTime": "2026-01-15T12:00:00Z",
  "toDateTime": "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
    },
    "calls": [
      {
        "id": "id_123",
        "url": "https://example.com",
        "title": "VP of Engineering"
      }
    ]
  }
}
```

Use `deepline describe gong_list_calls --json` for the latest machine-readable contract.

## Input reference

List calls that took place during a specified date range. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.

| 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.fromDateTime` | `string` | Yes | — | 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. For web-conference calls recorded by Gong, the date denotes its scheduled time, otherwise, it denotes its actual start time. |
| `payload.toDateTime` | `string` | Yes | — | 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. For web-conference calls recorded by Gong, the date denotes its scheduled time, otherwise, it denotes its actual start time. |
| `payload.workspaceId` | `string` | No | — | Optional Workspace identifier, if supplied the API will return only the calls belonging to this workspace. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "List calls that took place during a specified date range. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.",
    "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."
      },
      "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. For web-conference calls recorded by Gong, the date denotes its scheduled time, otherwise, it denotes its actual 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. For web-conference calls recorded by Gong, the date denotes its scheduled time, otherwise, it denotes its actual start time."
      },
      "workspaceId": {
        "type": "string",
        "description": "Optional Workspace identifier, if supplied the API will return only the calls belonging to this workspace."
      }
    },
    "required": [
      "fromDateTime",
      "toDateTime"
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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, in which each item specifies one call. |
| `result.data.calls[].id` | `string` | No | — | Gong's unique numeric identifier for the call (up to 20 digits). |
| `result.data.calls[].url` | `string` | No | — | The URL to the page in the Gong web application where the call is available. |
| `result.data.calls[].title` | `string` | No | — | The title of the call. |
| `result.data.calls[].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[].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[].duration` | `integer` | No | — | The duration of the call, in seconds. Format: `int64`. |
| `result.data.calls[].primaryUserId` | `string` | No | — | The primary user ID of the team member who hosted the call. |
| `result.data.calls[].direction` | `"Inbound" \| "Outbound" \| "Conference" \| "Unknown"` | No | — | Call direction. Allowed: `Inbound`, `Outbound`, `Conference`, `Unknown`. |
| `result.data.calls[].system` | `string` | No | — | The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.). |
| `result.data.calls[].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[].media` | `"Video" \| "Audio"` | No | — | Media type Allowed: `Video`, `Audio`. |
| `result.data.calls[].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[].workspaceId` | `string` | No | — | Gong's unique numeric identifier for the call's workspace (up to 20 digits). |
| `result.data.calls[].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[].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[].customData` | `string` | No | — | Metadata as was provided to Gong during the call creation via the Public API. |
| `result.data.calls[].purpose` | `string` | No | — | The purpose of the call. |
| `result.data.calls[].meetingUrl` | `string` | No | — | The meeting provider URL on which the web conference was recorded. |
| `result.data.calls[].isPrivate` | `boolean` | No | — | If the call is private. |
| `result.data.calls[].calendarEventId` | `string` | No | — | The Id of the meeting in Google or Outlook Calendar. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### 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
          },
          "calls": {
            "type": "array",
            "description": "A list, in which each item specifies one call.",
            "items": {
              "type": "object",
              "description": "call's metadata.",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Gong's unique numeric identifier for the call (up to 20 digits)."
                },
                "url": {
                  "type": "string",
                  "description": "The URL to the page in the Gong web application where the call is available."
                },
                "title": {
                  "type": "string",
                  "description": "The title of the call."
                },
                "scheduled": {
                  "type": "string",
                  "description": "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"
                },
                "started": {
                  "type": "string",
                  "description": "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"
                },
                "duration": {
                  "type": "integer",
                  "description": "The duration of the call, in seconds.",
                  "format": "int64"
                },
                "primaryUserId": {
                  "type": "string",
                  "description": "The primary user ID of the team member who hosted the call."
                },
                "direction": {
                  "type": "string",
                  "description": "Call direction.",
                  "enum": [
                    "Inbound",
                    "Outbound",
                    "Conference",
                    "Unknown"
                  ]
                },
                "system": {
                  "type": "string",
                  "description": "The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.)."
                },
                "scope": {
                  "type": "string",
                  "description": "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.",
                  "enum": [
                    "Internal",
                    "External",
                    "Unknown"
                  ]
                },
                "media": {
                  "type": "string",
                  "description": "Media type",
                  "enum": [
                    "Video",
                    "Audio"
                  ]
                },
                "language": {
                  "type": "string",
                  "description": "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)."
                },
                "workspaceId": {
                  "type": "string",
                  "description": "Gong's unique numeric identifier for the call's workspace (up to 20 digits)."
                },
                "sdrDisposition": {
                  "type": "string",
                  "description": "The SDR disposition of the call. This can be an automated value provided by the provider, or manually entered by the rep."
                },
                "clientUniqueId": {
                  "type": "string",
                  "description": "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."
                },
                "customData": {
                  "type": "string",
                  "description": "Metadata as was provided to Gong during the call creation via the Public API."
                },
                "purpose": {
                  "type": "string",
                  "description": "The purpose of the call."
                },
                "meetingUrl": {
                  "type": "string",
                  "description": "The meeting provider URL on which the web conference was recorded."
                },
                "isPrivate": {
                  "type": "boolean",
                  "description": "If the call is private."
                },
                "calendarEventId": {
                  "type": "string",
                  "description": "The Id of the meeting in Google or Outlook Calendar."
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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.