[GET] - New Contact Details

Follow

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

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
email 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)
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

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 &amp; Chief Executive Officer</title>
    </titles>
    <sources>
        <source>Social Media</source>
        <source>LinkSV</source>
        <source>CrowdFlower</source>
        <source>InsideView</source>
        <source>Reuters</source>
        <source>S&amp;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

 

Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk