---
title: "Retrieve a call"
slug: "retrieve-data-for-a-specific-call-v2callsid"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve data for a specific call (/v2/calls/{id})

Get/v2/calls/{id}

Retrieve data for a specific call.

Required authorizaton scope: 'api:calls:read:basic'.

Path parametersidstringRequired

Gong's unique numeric identifier for the call (up to 20 digits).

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='51c2812d-aac7-4aed-a3bf-9cd9bed1fe60'>application/json</option>
</select>Expand Allobject  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
callobject (CallBasicData)  

call's metadata.

idstring    

Gong's unique numeric identifier for the call (up to 20 digits).

Example7782342274025937895
urlstring    

The URL to the page in the Gong web application where the call is available.

Examplehttps://app.gong.io/call?id=7782342274025937895
titlestring    

The title of the call.

ExampleExample call
scheduledstring  (date-time)    

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

Example2018-02-17T10:30:00Z
startedstring  (date-time)    

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

Example2018-02-17T10:30:00Z
durationinteger  (int64)    

The duration of the call, in seconds.

Example460
primaryUserIdstring    

The primary user ID of the team member who hosted the call.

Example234599484848423
directionstring    

Call direction.

Valid values[
  "Inbound",
  "Outbound",
  "Conference",
  "Unknown"
]
systemstring    

The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.).

ExampleOutreach
scopestring    

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.

Valid values[
  "Internal",
  "External",
  "Unknown"
]ExampleInternal
mediastring    

Media type

Valid values[
  "Video",
  "Audio"
]ExampleVideo
languagestring    

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

Exampleeng
workspaceIdstring    

Gong's unique numeric identifier for the call's workspace (up to 20 digits).

Example623457276584334
sdrDispositionstring    

The SDR disposition of the call. This can be an automated value provided by the provider, or manually entered by the rep.

ExampleGot the gatekeeper
clientUniqueIdstring    

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.

Example7JEHFRGXDDZFEW2FC4U
customDatastring    

Metadata as was provided to Gong during the call creation via the Public API.

ExampleConference Call
purposestring    

The purpose of the call.

ExampleDemo Call
meetingUrlstring    

The meeting provider URL on which the web conference was recorded.

Examplehttps://zoom.us/j/123
isPrivateboolean    

If the call is private.

Examplefalse
calendarEventIdstring    

The Id of the meeting in Google or Outlook Calendar.

Exampleabcde@google.com

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='104a9b6f-5fb8-4da8-8c98-3eb3cad3af54'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='2adc85d0-6610-437b-ac89-665c4dec697a'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

404

Call ID was not found

<select class='api-response-data' aria-label='Media type'><option value='63a3fa9b-f9df-4a26-bc44-91a699297fac'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='7a9abe20-6ee0-4cb0-b4c9-16a671eba0db'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='eb921c98-bed9-4570-97fe-709925fc8a41'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string