List calls that took place during the specified date range.
Required authorizaton scope: 'api:calls:read:basic'.
When paging is needed, provide the cursor from the response of the previous API call to bring the next page.
From date and time in ISO-8601. Use UTC (Z) or a timezone offset such as -07:00. Returns calls on or after this time. For web-conference calls, the date is the scheduled time, otherwise, it's the actual start time.
To date and time in ISO-8601. Use UTC (Z) or a timezone offset such as -7:00. Returns calls that started before this date and time. For web-conference calls, the date is the scheduled time, otherwise, it's the actual start time.
Workspace identifier, if supplied the API only returns calls belonging to this workspace.
Successful response
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Information about the number of records that match the requested filter.
Total number of records.
Number of records in the current page.
Current page number.
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.
A list, in which each item specifies one call.
call's metadata.
Gong's unique numeric identifier for the call (up to 20 digits).
The URL to the page in the Gong web application where the call is available.
The title of the call.
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).
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).
The duration of the call, in seconds.
The primary user ID of the team member who hosted the call.
Call direction.
The system with which the call was carried out (e.g., WebEx, ShoreTel, etc.).
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.
Media type
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).
Gong's unique numeric identifier for the call's workspace (up to 20 digits).
The SDR disposition of the call. This can be an automated value provided by the provider, or manually entered by the rep.
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.
Metadata as was provided to Gong during the call creation via the Public API.
The purpose of the call.
The meeting provider URL on which the web conference was recorded.
If the call is private.
The Id of the meeting in Google or Outlook Calendar.
Malformed request
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Access denied
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
No calls found for the specified period
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
API request limit exceeded
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Failed to complete the operation due to an unexpected error
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.