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 | |
| 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 |
| 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 |
| jobLevels | Array | Array of Job levels |
| jobFunctions | Array | 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 |
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.",
"email": "mbenioff@salesforce.com",
"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"
],
"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>
<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>
<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