--- title: "Retrieve all data associated with a phone number" slug: "retrieve-all-references-to-a-phone-number-v2data-privacydata-for-phone-number" 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 all references to a phone number. (/v2/data-privacy/data-for-phone-number) Get/v2/data-privacy/data-for-phone-number Shows the elements in the Gong system that reference the given phone number. Given a phone number, this endpoint returns details of any leads or contacts with this phone number and their associated calls and email messages. Required authorizaton scope: 'api:data-privacy:read'. Query parametersphoneNumberstringRequired The phone number. This number must start with a + (plus) sign followed by the country code, area code, and local phone number. All other non-digits are ignored. The following are examples of permitted phone numbers: +1 425 555 2671, +1-425-555-2671, +1 425 5552671, +14255552671, +1 425 555 26 71, +1(425) 555-2671, etc. Note: This parameter should be URL-encoded. Example+1(425) 555-2671 Responses200 Successful request Expand Allobject requestIdstring A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes. Example4al018gzaztcr8nbukw emails Array of object (EmailMessage) Related email messages. object Related email messages. fromstring The sender's email address. Exampletest@test.com idstring Gong's unique 32 character identifier for the email message. Example223mjfaaqqjuegabiyrmpctvcwwl75oz sentTimestring The date and time the email message was sent in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC. Example2019-01-20T00:00:00-08:00 mailboxstring The mailbox from which the email was retrieved. Exampletest@test.com messageHashstring Hash code of the email message. Examplel3z7w2s7oircdabnkwizmycm6g2uwznc calls Array of object (CallReference) Related calls. object Details of a call referencing the email address. idstring Gong's unique numeric identifier for the call (up to 20 digits). Example7782342274025937895 statusstring Call status ExampleCOMPLETED externalSystems Array of object (ExternalSystem) A list of links to external systems such as CRM, Telephony System, Case Management, etc. object A list of links to external systems such as CRM, Telephony System, Case Management, etc. systemstring External system name. Valid values[ "Salesforce", "HubSpot", "MicrosoftDynamic", "Generic" ]ExampleSalesforce objects Array of object (ExternalSystemObject) List of objects within the external system. object List of objects within the external system. objectTypestring Object Type. Valid values[ "Conversation", "Task" ]ExampleTask externalIdstring External ID. Example0013601230sV7grAAC meetings Array of object (Meeting) Related meetings. object Related meetings. idstring Gong's unique identifier for the meeting. Example8059707022269524529.sb5gr1tgpt5dd799eh035rb3dk@google.com_2022-06-30T13:00:00Z customerData Array of object (CustomerData) A list of links to data from external systems (such as CRM, Telephony System, Case Management, etc.) that reference the email address and that Gong stores. object A list of links to data from external systems (such as CRM, Telephony System, Case Management, etc.) that reference the email address and that Gong stores. systemstring External system name. Valid values[ "Salesforce", "HubSpot", "MicrosoftDynamic", "Generic" ]ExampleSalesforce objects Array of object (CustomerDataObject) List of objects in the external system. object List of objects in the external system. idstring Gong's unique numeric identifier (up to 20 digits) for the Lead or Contact. Example7782342274025937895 objectTypestring Object Type. Valid values[ "Lead", "Contact" ]ExampleContact externalIdstring External ID. Example0013601230sV7grAAC mirrorIdstring Crm Mirror ID. Example"{\"integrationId\":\"262834820328732\",\"crmObjectType\":\"CONTACT\",\"crmId\":\"0031Q00002DFhi4QAD\"}" fields Array of object (ContextField) Object fields. 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. suppliedPhoneNumberstring The supplied phone number. matchingPhoneNumbers Array of string Matching phone numbers found. string Matching phone numbers found. emailAddresses Array of string Related email addresses. string Related email addresses. 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 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