[GET] - New Contact Details

  • Updated

Use the Get New Contact Details endpoint to fetch details about a contact once you know its new Contact ID. You can choose to retrieve all or some of the details of the contact.

Endpoint

GET https://api.insideview.com/api/v1/target/contact/{newContactId}

Request

HTTP Headers

Header Name Type Required Description
accessToken String Yes

Valid access token.
See Authentication and Authorization Overview for more details.

Accept String No Selects the response's content type.  
Valid values are application/json and application/xml (default).  

URI Parameters

To fetch newContactId, first run the [POST] - Contact List API. The newcontactId is unique for each customer and generated using your access token and client key. 

newContactId Example

<id>bDlLQimwlMbYNtkLuPNtJq5zCROoexiGP2msqLqo1Slld0-TRhlCrkTA_XGhG-Nv</id>
Parameter Name Type Required Description
newContactId String Yes New Contact ID

Query Parameters

Parameter Name Type Required Description
fields String No

Comma-separated list of fields to include in the response.  

Note: Use this parameter if you are interested in only a few fields to reduce the amount of data retrieved.

retrieveCompanyDetails Boolean No

If added and set to true, contact company details are in the response. 

Note: If not added, there are no contact company details in the response. 

Responses

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header. 

Name type Description
contactId Integer Contact ID
email String Contact email address
emailValidationStatus String  Returns the validation status of the email. Such as ValidEmail or ValidDomain 
facebookProfile String Contact Facebook profile URL
firstName String Contact first name
lastName String Contact last name
fullName String Contact full name
linkedInProfile String Contact LinkedIn profile URL
age String Age
salary String Salary
salaryCurrency String Salary Currency
phone String Contact phone number
phoneType String 

Returns CORPORATE, DIRECT, and MOBILE phone number of an executive.

Note: The Direct phone number is only available for InsideView customers and not OEM partners.

Mobile phone numbers are now available via the InsideView APIs for customers and partners who have purchased Elite or the mobile phone add-on to Enterprise. 

twitterProfile String Contact Twitter profile URL
description String Contact biography
imageUrl String Contact image URL
education Array Array of contact's education details
education degree String  
education  major String  
education university  String   
titles List List of contact's titles (String)
Confidence Score Double A percentage score based on Last validated date, Recency, Source, and Popularity
sources List List of sources for contact attributes (String)
active Boolean Active / inactive employment flag
jobLevelsV2 Array An array of a newer version of job levels
jobFunctionsV2 Array An array of a newer version of job functions
jobLevels Array An array of Job levels
jobFunctions Array An array of job functions
peopleId String People Id
companyDetails Object Contact's company.
companyDetails city String  Company address: city 
companyDetails companyId Integer Company InsideView id
companyDetails companyStatus String Company status (Operating, Subsidiary, ...)
companyDetails companyType String Company type (Private, Public, Subsidiary)
companyDetails country String Company address: country 
companyDetails employees String  Company employee count 
companyDetails equifaxId Integer Company Equifax id
companyDetails fax String Company fax number
companyDetails financialYearEnd String Company financial year end month
companyDetails industry String Company industry 
companyDetails industryCode String Company industry code.
companyDetails naics String Company NAICS code
companyDetails naicsDescription String Company NAICS description
companyDetails name String Company name
companyDetails parentCompanyId String Parent company InsideView id
companyDetails parentCompanyName String Parent company name
companyDetails parentCompanyCountry String Parent company country
companyDetails phone String Company phone number
companyDetails revenue String Company revenue (Millions of $)
companyDetails revenueCurrency String Company revenue's currency (USD, EUR, GBP)
companyDetails sic String Company SIC code
companyDetails sicDescription String Company SIC description
companyDetails employeeRange String Range of number of employees
companyDetails revenueRange String Range of company revenue
companyDetails foundationDate String Foundation date of the company
companyDetails gender String Diversity status based on Gender
companyDetails ethnicity String Diversity status based on Ethnicity
companyDetails dbe Boolean Diversity status based on Disadvantages Business Ent. 
companyDetails wbe  Boolean Diversity status based on Women Business Ent. 
companyDetails mbe  Boolean Diversity status based on Minority Business Ent. 
companyDetails vbe  Boolean Diversity status based on Veteran Business Ent.
companyDetails disabled  Boolean Diversity status based on Disabled Business Ent. 
companyDetails lgbt Boolean Diversity status based on Gay Lesbian business Ent. 
companyDetails companyTaxId String US Company Tax Id (if available)
companyDetails sources List List of sources for company attributes (String)
companyDetails state String Company address: state
companyDetails street String Company address: street
companyDetails subIndustry String Company sub-industry
companyDetails subIndustryCode String Company sub-industry code
companyDetails subsidiary Boolean Indicates wether the company is a subsidiary or not.
companyDetails ticker Array Array of company's tickers details
companyDetails ticker tickerName String  Ticker symbol 
companyDetails ticker exchange  String  Exchange symbol
companyDetails ultimateParentCompanyId String Ultimate parent company InsideView id
companyDetails ultimateParentCompanyName String Ultimate parent company name
companyDetails ultimateParentCompanyCountry String Ultimate parent company country
companyDetails zip String Company address: zip code 
companyDetails websites List List of company's web site URL (String)
companyDetails britishSics List  List of British SIC Codes
companyDetails britishSics britishSic String British SIC code
companyDetails britishSics description String  British SIC code description
companyDetails companyFacebookProfile String  Facebook profile of Company
companyDetails companyTwitterProfile String  Twitter Profile of Company
companyDetails companyBlogProfile String  Blog Url of Company
companyDetails companyLinkedInProfile String  LinkedIn profile of Company

businessStructure

String 

The organizational structure of a company (globalParent, uncategorized, subsidiary, group, independent) 

companyStatusV2

String 

Company status (operating, non-Operating, acquired, liquidating, outOfBusiness, unassigned

companyTypeV2

String 

Company type (public, private, government, organization, unknown)

siteCount

String 

Number of company sites

siteLocationCount

String 

Number of company sites that has site related information

siteTypes

String 

Type of a site

application/json Example

{
"contactId": 25328405,
"firstName": "Jeffrey",
"lastName": "Weiner",
"imageUrl": "https://pbs.twimg.com/profile_images/629368068590960641/HDbeZ4bL.jpg",
"companyId": 726263,
"companyName": "Microsoft Corporation",
"phone": "+1 425 882 8080",
"twitterHandle": "https://twitter.com/jeffweiner",
"linkedinHandle": "https://www.linkedin.com/in/jeffweiner08/",
"companyDetails": {
"name": "Microsoft Corporation",
"companyType": "Public",
"companyStatus": "Operating",
"tickers": [
{
"tickerName": "MSFT",
"exchange": "NASD"
}
],
"industry": "Computer Software",
"subIndustry": "Computer Software",
"street": "One Microsoft Way",
"city": "Redmond",
"state": "WA",
"zip": "98052-6399",
"country": "United States",
"phone": "+1 425 882 8080",
"revenue": "192557.0",
"employees": "181000",
"subsidiary": "false",
"sic": "7372",
"sicDescription": "Services-Prepackaged Software",
"naics": "513210",
"naicsDescription": "Software Publishers",
"financialYearEnd": "6",
"equifaxId": "049615062",
"fortuneRanking": "14",
"mostRecentQuarter": "Mar, 2022",
"revenueCurrency": "USD",
"industryCode": "8",
"subIndustryCode": "8",
"britishSics": [
{
"britishSic": "46510",
"description": "Wholesale of computers, computer peripheral equipment and software"
},
{
"britishSic": "58210",
"description": "Publishing of computer games"
},
{
"britishSic": "62011",
"description": "Ready-made interactive leisure and entertainment software development"
},
{
"britishSic": "58290",
"description": "Other software publishing"
}
],
"foundationDate": "1975",
"companyTaxId": "911144442",
"companyFacebookProfile": "Microsoft",
"companyTwitterProfile": "Microsoft",
"companyBlogProfile": "https://news.microsoft.com/feed/",
"companyLinkedInProfile": "https://www.linkedin.com/company/microsoft/",
"latitude": "47.6400493830442",
"longitude": "-122.129796892405",
"siteCount": 276,
"siteLocationCount": 82,
"businessStructure": "globalParent",
"companyTypeV2": "Public",
"companyStatusV2": "Operating",
"websites": [
"https://www.microsoft.com/en-us/"
],
"siteTypes": [
"Uncategorized"
],
"sources": [
"User Generated",
"Web References",
"Reuters",
"InsideView",
"Community",
"Equifax"
],
"companyId": 726263
},
"age": "52",
"active": true,
"jobLevels": [
"Board"
],
"jobFunctions": [
"Other"
],
"jobLevelsV2": [
{
"id": "0",
"name": "Board Member"
}
],
"jobFunctionsV2": [
{
"id": "22",
"name": "Others"
}
],
"peopleId": "Kt2BCEoVy4_94-MotFgTNPKJRtPXpiRr2Ke1inzzqGXgSfXF_GwWf2XRGIZDPlPl",
"fullName": "Jeffrey Weiner",
"confidenceScore": 79.0,
"corporatePhone": "+1 425 882 8080",
"mobileNumber": [
"+1 914 906 9385"
],
"education": [
{
"degree": "Bachelor of Science",
"major": "Economics",
"university": "The Wharton School of the University of Pennsylvania"
}
],
"titles": [
"Executive Chairman, LinkedIn"
],
"sources": [
"Web References",
"Social Media",
"LinkSV",
"Reuters",
"InsideView",
"Community"
]
}

application/xml Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contact>
<educations>
<education>
<degree>Bachelor of Science</degree>
<major>Economics</major>
<university>The Wharton School of the University of Pennsylvania</university>
</education>
</educations>
<titles>
<title>Executive Chairman, LinkedIn</title>
</titles>
<sources>
<source>Web References</source>
<source>Social Media</source>
<source>LinkSV</source>
<source>Reuters</source>
<source>InsideView</source>
<source>Community</source>
</sources>
<jobLevels>
<jobLevel>Board</jobLevel>
</jobLevels>
<jobFunctions>
<jobFunction>Other</jobFunction>
</jobFunctions>
<jobLevelsV2>
<jobLevelV2>
<id>0</id>
<name>Board Member</name>
</jobLevelV2>
</jobLevelsV2>
<jobFunctionsV2>
<jobFunctionV2>
<id>22</id>
<name>Others</name>
</jobFunctionV2>
</jobFunctionsV2>
<active>true</active>
<age>52</age>
<companyDetails>
<companyId>726263</companyId>
<tickers>
<ticker>
<exchange>NASD</exchange>
<tickerName>MSFT</tickerName>
</ticker>
</tickers>
<websites>
<website>https://www.microsoft.com/en-us/</website>
</websites>
<sources>
<source>User Generated</source>
<source>Web References</source>
<source>Reuters</source>
<source>InsideView</source>
<source>Community</source>
<source>Equifax</source>
</sources>
<britishSics>
<britishSicDetails>
<britishSic>46510</britishSic>
<description>Wholesale of computers, computer peripheral equipment and software</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>58210</britishSic>
<description>Publishing of computer games</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>62011</britishSic>
<description>Ready-made interactive leisure and entertainment software development</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>58290</britishSic>
<description>Other software publishing</description>
</britishSicDetails>
</britishSics>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<businessStructure>globalParent</businessStructure>
<city>Redmond</city>
<companyBlogProfile>https://news.microsoft.com/feed/</companyBlogProfile>
<companyFacebookProfile>Microsoft</companyFacebookProfile>
<companyLinkedInProfile>https://www.linkedin.com/company/microsoft/</companyLinkedInProfile>
<companyStatus>Operating</companyStatus>
<companyStatusV2>Operating</companyStatusV2>
<companyTaxId>911144442</companyTaxId>
<companyTwitterProfile>Microsoft</companyTwitterProfile>
<companyType>Public</companyType>
<companyTypeV2>Public</companyTypeV2>
<country>United States</country>
<employees>181000</employees>
<equifaxId>049615062</equifaxId>
<financialYearEnd>6</financialYearEnd>
<fortuneRanking>14</fortuneRanking>
<foundationDate>1975</foundationDate>
<industry>Computer Software</industry>
<industryCode>8</industryCode>
<latitude>47.6400493830442</latitude>
<longitude>-122.129796892405</longitude>
<mostRecentQuarter>Mar, 2022</mostRecentQuarter>
<naics>513210</naics>
<naicsDescription>Software Publishers</naicsDescription>
<name>Microsoft Corporation</name>
<phone>+1 425 882 8080</phone>
<revenue>192557.0</revenue>
<revenueCurrency>USD</revenueCurrency>
<sic>7372</sic>
<sicDescription>Services-Prepackaged Software</sicDescription>
<siteCount>276</siteCount>
<siteLocationCount>82</siteLocationCount>
<state>WA</state>
<street>One Microsoft Way</street>
<subIndustry>Computer Software</subIndustry>
<subIndustryCode>8</subIndustryCode>
<subsidiary>false</subsidiary>
<zip>98052-6399</zip>
</companyDetails>
<companyId>726263</companyId>
<companyName>Microsoft Corporation</companyName>
<confidenceScore>79.0</confidenceScore>
<contactId>25328405</contactId>
<corporatePhone>+1 425 882 8080</corporatePhone>
<firstName>Jeffrey</firstName>
<fullName>Jeffrey Weiner</fullName>
<imageUrl>https://pbs.twimg.com/profile_images/629368068590960641/HDbeZ4bL.jpg</imageUrl>
<lastName>Weiner</lastName>
<linkedinHandle>https://www.linkedin.com/in/jeffweiner08/</linkedinHandle>
<mobileNumber>+1 914 906 9385</mobileNumber>
<peopleId>Kt2BCEoVy4_94-MotFgTNPKJRtPXpiRr2Ke1inzzqGXgSfXF_GwWf2XRGIZDPlPl</peopleId>
<phone>+1 425 882 8080</phone>
<twitterHandle>https://twitter.com/jeffweiner</twitterHandle>
</contact>

 

HTTP 400

Invalid query parameter(s)

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in header

HTTP 404

Invalid ID, record not found.

HTTP 429

Request is throttled

 

Was this article helpful?

0 out of 0 found this helpful