--- title: "Retrieve call data" slug: "retrieve-detailed-call-data-by-various-filters-v2callsextensive-2" 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 detailed call data by various filters (/v2/calls/extensive) Post/v2/calls/extensive Lists detailed call data for calls that took place during a specified date range, have specified call IDs or hosted by specified users. Required authorizaton 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'. Body parametersExpand Allobject cursorstring When paging is needed, provide the value supplied by the previous API call to bring the following page of records. ExampleeyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM filterobject (CallsRequestFilterWithOwners) Required Filter parameters. fromDateTimestring 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. Example2018-02-17T02:30:00-08:00 toDateTimestring 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. Example2018-02-19T02:30:00-08:00 workspaceIdstring Optional Workspace identifier, if supplied the API will return only the calls belonging to this workspace. Example623457276584334 callIds Array of string List of calls Ids to be filtered. If not supplied, returns all calls between fromDateTime and toDateTime. Example[ "7782342274025937895" ]string primaryUserIds Array of string 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. Example[ "7782342274025937895" ]string contentSelectorobject (ContentSelector) The content selector identifies which data components, if any, are needed, by the caller contextstring 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' Valid values[ "None", "Basic", "Extended" ] contextTiming Array of string 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' string 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' Valid values[ "Now", "TimeOfCall" ] exposedFieldsobject (ExposedFields) The exposed fields identifies which field, if any, are returned in the response object partiesboolean If true, add information about the parties of the call Exampletrue contentobject (CallContent) The content of the call structureboolean If true, add call agenda, if available Examplefalse topicsboolean If true, add duration of call topics Examplefalse trackersboolean If true, returns smart tracker and keyword tracker information for the call. Examplefalse trackerOccurrencesboolean 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. Examplefalse pointsOfInterestboolean deprecated. Examplefalse briefboolean When true, returns the spotlight call brief. Exampletrue outlineboolean When true, returns the call outline. Exampletrue highlightsboolean When true, returns the call highlights. Exampletrue callOutcomeboolean When true, returns the outcome of the call. Exampletrue keyPointsboolean When true, returns the key points of the call. Exampletrue interactionobject (CallInteraction) The interaction data of the call speakersboolean If true, add the time each participant spoke. Exampletrue videoboolean If true, add video statistics Exampletrue personInteractionStatsboolean If true, add statistics for the host of the call. Exampletrue questionsboolean If true, add question counts Exampletrue collaborationobject (CallCollaboration) Call collaboration publicCommentsboolean If true, add public comments made for this call Exampletrue mediaboolean If true and exist, add audio url and video url of the call. The urls will be available for 8 hours. Exampletrue Responses200 Successful response Expand Allobject requestIdstring A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes. Example4al018gzaztcr8nbukw recordsobject (Records) Information about the number of records that match the requested filter. totalRecordsinteger (int32) Total number of records. Example263 currentPageSizeinteger (int32) Number of records in the current page. Example100 currentPageNumberinteger (int32) Current page number. Example0 cursorstring 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. ExampleeyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM calls Array of object (CallData) A list with one entry per call. object A list with one entry per call. metaDataobject (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 context Array of object (CallContextDto) A list of the agenda of each part of the call. object Links to external systems such as CRM, Dialer, Case Management etc systemstring External system name. e.g. Salesforce Valid values[ "Salesforce", "HubSpot", "MicrosoftDynamic", "Generic" ]ExampleSalesforce objects Array of object (ExternalCallObject) List of objects within the external system object External Object objectTypestring Object Type. e.g Opportunity. Valid values[ "Opportunity", "Account" ]ExampleOpportunity objectIdstring Object ID Example0013601230sV7grAAC fields Array of object (ContextField) object External object data namestring 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. Examplename valueobject Field value ExampleGong Inc. timingstring Timing of object Valid values[ "Now", "TimeOfCall" ] parties Array of object (Party) A list of the call's participants object idstring Unique ID of the participant in the call. Example56825452554556 emailAddressstring Email address. Exampletest@test.com namestring The name of the participant. ExampleTest User titlestring The job title of the participant ExampleEnterprise Account Executive userIdstring The user ID of the participant within the Gong system, if the participant exists in the system. Example234599484848423 speakerIdstring Unique ID of a participant that spoke in the call. References to this id will appear in the '/v2/calls/transcript' endpoint response. Example6432345678555530067 context Array of object (PartyContextDto) A list of links to external systems such as CRM, Dialer, Case Management, etc. object Links to external systems such as CRM, Dialer, Case Management etc systemstring External system name. e.g. Salesforce Valid values[ "Salesforce", "HubSpot", "MicrosoftDynamic", "Generic" ]ExampleSalesforce objects Array of object (ExternalPartyObject) List of objects within the external system object External Object objectTypestring Object Type. e.g. Lead Valid values[ "Contact", "User", "Lead" ]ExampleContact objectIdstring Object ID Example0013601230sV7grAAC fields Array of object (PartyContextField) Object fields object External object data namestring Field name. All custom fields are supported. Examplename valueobject Object value ExampleGong Inc. timingstring Timing of object Valid values[ "Now", "TimeOfCall" ] affiliationstring Whether the participant is from the company or not. Valid values[ "Internal", "External", "Unknown" ] phoneNumberstring The phone number of the participant. Example+1 123-567-8989 methods Array of string Whether the participant was invited to the meeting or only attended the call. string Whether the participant was invited to the meeting or only attended the call. Valid values[ "Invitee", "Attendee" ] contentobject (ContentDto) Analysis of the interaction content. structure Array of object (StructureDto) A list of the agenda of each part of the call. object Agenda of the current part of the call namestring The agenda name ExampleMeeting Setup durationinteger (int64) The duration of this part of the call Example67 trackers Array of object (TrackerDto) object idstring The unique ID of the Tracker. Example56825452554556 namestring The name of the Tracker (e.g., Stores). ExampleCompetitors countinteger (int32) The number of times words in this Tracker occurred in the call. Example7 typestring The type of the tracker - Keyword or Smart. Valid values[ "KEYWORD", "SMART" ]ExampleKEYWORD occurrences Array of object (occurrences) Details when the smart or keyword tracker term came up in the call. The list does not specify each phrase defined in the tracker, rather it lists when any term relevant to the tracker was mentioned. Empty when keyword trackers are set to display each term in the tracker separately. object startTimenumber (double) The number of seconds from the beginning of the call when the tracker phrase was captured. Example32.56 speakerIdstring Unique ID of the speaker in the call who said the tracker term. Same as the speakerID in the "parties" field and in the transcript. Example234599484848423 phrases Array of object (trackerPhrases) Details when each specific phrase defined in the keyword tracker came up in the call. Smart trackers are not listed. object countinteger (int32) The number of times this phrase was mentioned in the call. Example5 occurrences Array of object (occurrences) Lists when each keyword tracker phrase was mentioned in the call. object startTimenumber (double) The number of seconds from the beginning of the call when the tracker phrase was captured. Example32.56 speakerIdstring Unique ID of the speaker in the call who said the tracker term. Same as the speakerID in the "parties" field and in the transcript. Example234599484848423 phrasestring The specific phrase within the tracker (e.g., Walmart). ExampleWalmart topics Array of object (TopicDto) object namestring The name of the topic (e.g., Pricing). ExampleObjections durationinteger (int32) The total time, in seconds, spent on this topic within the call. Example86 briefstring The brief of the call. Returned when it is available and contentSelector.exposedFields.content.brief = true. outline Array of object (CallOutlineSection) Outline of the call, divided into sections. Returned when it is available and contentSelector.exposedFields.content.outline = true. object sectionstring The name of this section of the call. startTimenumber (double) The starting time of this section, in seconds, from the start of the call. durationnumber (double) The duration of this section, in seconds. items Array of object (CallOutlineItem) List of items of this section. object textstring The text of this section item. startTimenumber (double) The starting time of this section item, in seconds from the start of the call. highlights Array of object (CallHighlightsSection) List of highlights of the call. Returned when it is available and contentSelector.exposedFields.content.highlights = true. object titlestring The title of the highlights section. items Array of object (CallHighlightsItem) List of highlight items of the call in this section. object textstring The text of the highlights section item. startTimes Array of number List of starting times of the highlights section item, in seconds from the start of the call. number (double) callOutcomeobject (CallOutcome) The outcome of the call, as automatically set by Gong AI. Returned when it is available and contentSelector.exposedFields.content.callOutcome = true. idstring The ID of the call outcome, as automatically set by Gong AI ExampleMEETING_BOOKED categorystring The category of the call outcome, as automatically set by Gong AI ExampleAnswered namestring The name of the call outcome, as automatically set by Gong AI ExampleMeeting booked keyPoints Array of object (CallKeyPoint) List of key points of the call. Returned when it is available and contentSelector.exposedFields.content.keyPoints = true. object textstring The text of the key point. interactionobject (InteractionMeasuresDto) Metrics collected around the interaction during the call. speakers Array of object (UserSpeaker) A list of the talk duration per speaker. object Talking duration idstring Unique ID of the participant in the call. Example56825452554556 userIdstring User Id within the Gong system Example234599484848423 talkTimenumber (double) Talk duration in seconds Example145.0 interactionStats Array of object (InteractionStatsDto) A list of interaction statistics. Applicable values: 'Talk Ratio', 'Longest Monologue', 'Longest Customer Story', 'Interactivity', 'Patience'. object Interaction statistics namestring Stat name ExampleInteractivity valuenumber Stat measurement Example56.0 video Array of object (VideoInteractionDto) A list of video statistics about what's presented and for how long. object Video statistics namestring Video segment type. Can have the values: 'Browser', 'Presentation', 'WebcamPrimaryUser', 'WebcamNonCompany', and 'Webcam'. **'Browser'**: When the video segment shows a web browser. **'Presentation'**: When the video segment shows a presentation (such as PowerPoint). **'WebcamPrimaryUser'**: When the video segment shows the webcam of the primary user. **'WebcamNonCompany'**: When the video segment shows webcam speakers that gong has identified as being non-company. **'Webcam'**: When the video segment shows any webcam. ExampleBrowser durationnumber (float) Total video segments duration in seconds. Example218.0 questionsobject (Questions) Question counts of the call. companyCountinteger (int32) The number of questions asked by company speakers. nonCompanyCountinteger (int32) The number of questions asked by non-company speakers. collaborationobject (CollaborationDto) Collaboration information added to the call publicComments Array of object (CommentDto) A list of public comments. object idstring Unique identifier of the comment within the Gong's system. Example6843152929075440037 audioStartTimenumber (float) The number of seconds from the beginning of the call that the comment start refers to. Example26.0 audioEndTimenumber (float) The number of seconds from the beginning of the call that the comment ends refers to. Example26.0 commenterUserIdstring Unique identifier of the user who wrote the comment. Example234599484848423 commentstring The comment itself. The comment may contains person tagging in this format @[user name](user Id) Examplenew comment postedstring (date-time) The date and time 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); in which the comment was posted. Example2018-02-17T10:30:00Z inReplyTostring The unique identifier of the original comment in case the current comment is a reply to the original one. Example792390015966656336 duringCallboolean True if the comment was written during the call, false if it was posted after the call. mediaobject (MediaDto) The media urls of the call. audioUrlstring (url) If true and exist, add audio url of the call. The url will be available for 8 hours. videoUrlstring (url) If true and exist, add video url of the call. The url will be available for 8 hours. 400 Malformed request 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 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 No calls found for the specified period 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. 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 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