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. |
Accept | String | No | Selects the response's content type. Valid values are application/json and application/xml (default). |
URI Parameters
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 |
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