> ## 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: Get Call

> Get one Gong call's details, such as title, time, duration, and link, by call ID. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Get one Gong call's details, such as title, time, duration, and link, by call ID.

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

## 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_get_call',
  {
    "id": "id_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_get_call --input '{
  "id": "id_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",
    "call": {
      "id": "id_123",
      "url": "https://example.com",
      "title": "VP of Engineering"
    }
  }
}
```

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

## Input reference

Retrieve data for a specific call. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Gong's unique numeric identifier for the call (up to 20 digits). |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve data for a specific call. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Gong's unique numeric identifier for the call (up to 20 digits)."
      }
    },
    "required": [
      "id"
    ],
    "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.call` | `object` | No | — | call's metadata. |
| `result.data.call.id` | `string` | No | — | Gong's unique numeric identifier for the call (up to 20 digits). |
| `result.data.call.url` | `string` | No | — | The URL to the page in the Gong web application where the call is available. |
| `result.data.call.title` | `string` | No | — | The title of the call. |
| `result.data.call.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.call.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.call.duration` | `integer` | No | — | The duration of the call, in seconds. Format: `int64`. |
| `result.data.call.primaryUserId` | `string` | No | — | The primary user ID of the team member who hosted the call. |
| `result.data.call.direction` | `"Inbound" \| "Outbound" \| "Conference" \| "Unknown"` | No | — | Call direction. Allowed: `Inbound`, `Outbound`, `Conference`, `Unknown`. |
| `result.data.call.system` | `string` | No | — | The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.). |
| `result.data.call.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.call.media` | `"Video" \| "Audio"` | No | — | Media type Allowed: `Video`, `Audio`. |
| `result.data.call.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.call.workspaceId` | `string` | No | — | Gong's unique numeric identifier for the call's workspace (up to 20 digits). |
| `result.data.call.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.call.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.call.customData` | `string` | No | — | Metadata as was provided to Gong during the call creation via the Public API. |
| `result.data.call.purpose` | `string` | No | — | The purpose of the call. |
| `result.data.call.meetingUrl` | `string` | No | — | The meeting provider URL on which the web conference was recorded. |
| `result.data.call.isPrivate` | `boolean` | No | — | If the call is private. |
| `result.data.call.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."
          },
          "call": {
            "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.