Articles in this section

See more

[GET] - Contact Details

Nitin Singh Sisodia
  • Updated
Follow

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

The contact id can be obtained either through the Data API Contact Search or through the Enrich API Enrich (or its bulk version).

Endpoint

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

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
contactId String Yes 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.
Ex: fields=lastName,firstName,twitterHandle

Responses

HTTP 200

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

Name type Description
companyId Integer Contact's company InsideView ID
companyName String Contact's company name
contactId Integer Contact InsideView ID
description String Contact bio
email String Contact email address
facebookHandle String Contact Facebook profile URL
firstName String Contact first name
lastName String Contact last name
fullName String Contact full name
imageUrl String Contact image URL
linkedinHandle String Contact LinkedIn profile URL
phone String Contact phone number
confidenceScore String The min or maximum confidence score for a contact's email
emailValidationStatus String Return the validation status of the email. Such as ValidEmail or ValidDomain
twitterHandle String Contact Twitter profile 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
age String Age
salary String Salary
salaryCurrency String Salary Currency
phoneType String Returns CORPORATE and DIRECT phone number of an executive.

application/json example

{
  "contactId": 6328347,
  "firstName": "Tim",
  "lastName": "Cook",
  "companyId": 1058007,
  "companyName": "Apple Computer UK",
  "phone": "+44 800 039 1010",
  "corporate": +44 800 039 1010",
  "direct":+939 4321 3433,
  "confidenceScore": 0.86,
  "twitterHandle": "http://twitter.com/T_Cook",
  "facebookHandle": "http://www.facebook.com/135724710121292",
  "age": "54",
  "active": false,
  "jobLevels": [
    "C Level"
  ],
  "jobFunctions": [
    "Other"
  ],
  "peopleId": "ZWUf25_lqO7SY_AEoCa9H23wj0W_7eCqHbJO3nw_7gcFrg2vQ0LZ2iS0pCse8MlD",
  "fullName": "Tim Cook",
  "education": [
    {
      "degree": "Bachelor of Science",
      "major": "Industrial Engineering",
      "university": "Auburn University"
    },
    {
      "degree": "Masters of Business Administration",
      "major": "",
      "university": "Duke University"
    }
  ],
  "sources": [
    "Web References",
    "Social Media",
    "InsideView",
    "Reuters",
    "Community"
  ],
  "titles": [
    "CEO, Apple Inc."
  ]
}

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contact>
    <contactId>6328347</contactId>
    <educations>
        <education>
            <degree>Bachelor of Science</degree>
            <major>Industrial Engineering</major>
            <university>Auburn University</university>
        </education>
        <education>
            <degree>Masters of Business Administration</degree>
            <major></major>
            <university>Duke University</university>
        </education>
    </educations>
    <companyId>1058007</companyId>
    <titles>
        <title>CEO, Apple Inc.</title>
    </titles>
    <sources>
        <source>Web References</source>
        <source>Social Media</source>
        <source>InsideView</source>
        <source>Reuters</source>
        <source>Community</source>
    </sources>
    <jobLevels>
        <jobLevel>C Level</jobLevel>
    </jobLevels>
    <jobFunctions>
        <jobFunction>Other</jobFunction>
    </jobFunctions>
    <active>false</active>
    <age>54</age>
    <companyName>Apple Computer UK</companyName>
    <confidenceScore>0.86</confidenceScore>
    <email>tcook@apple.com</email>
    <emailValidationStatus>ValidEmail</emailValidationStatus>
    <emails>
     <email>
       <email>tcook@apple.com</email>
       <ValidationStatus>ValidEmail</ValidationStatus>
     </email>
    </emails> 
    <facebookHandle>http://www.facebook.com/135724710121292</facebookHandle>
    <firstName>Tim</firstName>
    <fullName>Tim Cook</fullName>
    <lastName>Cook</lastName>
    <peopleId>ZWUf25_lqO7SY_AEoCa9H23wj0W_7eCqHbJO3nw_7gcFrg2vQ0LZ2iS0pCse8MlD</peopleId>
    <phone>+44 800 039 1010</phone>
    <phoneType>+44 800 039 1010</phoneType>
    <twitterHandle>http://twitter.com/T_Cook</twitterHandle>
</contact>

HTTP 400

Invalid query parameter(s).

HTTP 401

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

HTTP 405

Method Not Allowed - Your are not allowed to access this API.

HTTP 404

Invalid ID, record not found.

HTTP 429

Request is throttled.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk