[GET] - Contact Details

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

URI Parameters

Query Parameters

Responses

HTTP 200

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

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"
  ],

  "jobLevelsV2": {
      "id": "jobLevelsV2",
      "type": "array",
      "items": {
        "id": "0",
        "type": "object",
        "properties": {
          "id": {
            "id": "id",
            "type": "string"
          },
          "name": {
            "id": "name",
            "type": "string"
          }
        }
      }
    },
    "jobFunctionsV2": {
      "id": "jobFunctionsV2",
      "type": "array",
      "items": {
        "id": "0",
        "type": "object",
        "properties": {
          "id": {
            "id": "id",
            "type": "string"
          },
          "name": {
            "id": "name",
            "type": "string"
          }
        }
      }
    },
  "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>
    <jobLevelsV2>
       <jobLevelV2>
           <id>0</id>
           <name>Board Member</name>
        </jobLevelV2>
    </jobLevelsV2>
        <jobLevelV2>
            <id>1</id>
            <name>C Level </name>
         <jobLevelV2>
     </jobLevelsV2>
    <jobFunctionsV2>
       <jobFunctionV2>
           <id>22</id>
           <name>others</name>
        </jobFunctionV2>
     </jobFunctionsV2>
    <jobLevelsV2>
    <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.