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
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. Use this parameter if you are interested in only a few fields to reduce the amount of data retrieved. |
retrieveCompanyDetails | Boolean | No | If set to true, adds the details of the contact's company to 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 (global parent, uncategorized, subsidiary, group, branch, 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": 39776, "firstName": "Marc", "lastName": "Benioff", "imageUrl": "https://pbs.twimg.com/profile_images/691129678178885632/6SnYdI1F_normal.jpg", "companyId": 735859, "companyName": "salesforce.com, inc.",
"confidenceScore": "0.86",
"corporate" : "+44 800 039 1010",
"direct" : "+939 4321 3433"
"mobileNumber": "+1 924 308 215" "email": "mbenioff@salesforce.com",
"emailValidStatus": "ValidEmail", "description": " Mr. Marc R. Benioff is Chairman of the Board, Director, Chief Executive Officer of Salesforce.com Inc. He co-founded Salesforce in February 1999 and has served as our Chairman of the Board of Directors since inception. He has served as our Chief Executive Officer since 2001. From 1986 to 1999, Mr. Benioff was employed at Oracle Corporation, where he held a number of positions in sales, marketing and product development, lastly as a Senior Vice President. Mr. Benioff also serves as Chairman of the Board of Directors of the Salesforce.com Foundation, and as a member of the board of trustees of the World Economic Forum. In the past five years, Mr. Benioff served as a member of the Board of Directors of Cisco Systems, Inc. Mr. Benioff received a B.S. in Business Administration from the University of Southern California, where he is also on the Board of Trustees.", "twitterHandle": "http://twitter.com/Benioff", "linkedinHandle": "http://www.linkedin.com/in/marcbenioff", "age": "48", "salary": "1,440,000", "salaryCurrency": "USD", "active": true, "jobLevels": [ "Board", "C Level" ], "jobFunctions": [ "Other" ], "jobLevelsV2": [ { "id": "0", "name": "Board Member" }, { "id": "1", "name": "C Level" } ], "jobFunctionsV2": [ { "id": "22", "name": "Others" } ], "peopleId": "w4P0m1r1qTFPvYgIXc-L_O-vHXyoCJFv9ApzxJIkS03SmGQHss-rDxsMz4-zSeyG", "fullName": "Marc Benoiff", "titles": [ "Chairman & Chief Executive Officer" ], "education": [ { "degree": "Bachelor of Science", "major": "Business Administration", "university": "University of Southern California" } ], "sources": [ "Social Media", "LinkSV", "CrowdFlower", "InsideView", "Reuters", "S&P Capital IQ", "Community" ] }
application/xml Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <contact> <contactId>39776</contactId> <educations> <education> <degree>Bachelor of Science</degree> <major>Business Administration</major> <university>University of Southern California</university> </education> </educations> <companyId>735859</companyId> <titles> <title>Chairman & Chief Executive Officer</title> </titles> <sources> <source>Social Media</source> <source>LinkSV</source> <source>CrowdFlower</source> <source>InsideView</source> <source>Reuters</source> <source>S&p Capital IQ</source> <source>Community</source> </sources> <jobLevels> <jobLevel>Board</jobLevel> <jobLevel>C Level</jobLevel> </jobLevels> <jobFunctions> <jobFunction>Other</jobFunction> </jobFunctions> <jobLevelsV2> <jobLevelV2> <id>0</id> <name>Board Member</name> </jobLevelV2> <jobLevelV2> <id>2</id> <name>Senior Executive</name> </jobLevelV2> </jobLevelsV2> <jobFunctionsV2> <jobFunctionV2> <id>22</id> <name>Others</name> </jobFunctionV2> </jobFunctionsV2> <active>true</active> <age>48</age> <companyName>salesforce.com, inc.</companyName> <description> Mr. Marc R. Benioff is Chairman of the Board, Director, Chief Executive Officer of Salesforce.com Inc. He co-founded Salesforce in February 1999 and has served as our Chairman of the Board of Directors since inception. He has served as our Chief Executive Officer since 2001. From 1986 to 1999, Mr. Benioff was employed at Oracle Corporation, where he held a number of positions in sales, marketing and product development, lastly as a Senior Vice President. Mr. Benioff also serves as Chairman of the Board of Directors of the Salesforce.com Foundation, and as a member of the board of trustees of the World Economic Forum. In the past five years, Mr. Benioff served as a member of the Board of Directors of Cisco Systems, Inc. Mr. Benioff received a B.S. in Business Administration from the University of Southern California, where he is also on the Board of Trustees.</description> <email>mbenioff@salesforce.com</email>
<confidenceScore>0.86</confidenceScore>
<email>mbenioff@salesforce.com</email>
<emailValidationStatus>ValidEmail</emailValidationStatus>
<emails>
<email>
<email>mbenioff@salesforce.com</email>
<ValidationStatus>ValidEmail</ValidationStatus>
</email>
</emails>
<firstName>Marc</firstName> <fullName>Marc Benoiff</fullName> <imageUrl>https://pbs.twimg.com/profile_images/691129678178885632/6SnYdI1F_normal.jpg</imageUrl> <lastName>Benioff</lastName> <linkedinHandle>http://www.linkedin.com/in/marcbenioff</linkedinHandle> <peopleId>w4P0m1r1qTFPvYgIXc-L_O-vHXyoCJFv9ApzxJIkS03SmGQHss-rDxsMz4-zSeyG</peopleId> <salary>1,440,000</salary> <salaryCurrency>USD</salaryCurrency> <twitterHandle>http://twitter.com/Benioff</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
Comments
0 comments
Please sign in to leave a comment.