[GET] - Contact Details – Knowledge Base

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
jobLevelsV2	Array	An array of the new version of job levels
jobFunctionsV2	Array	An array of the newer version of the job functions
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, 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.

Type: application/json

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "type": "object",
  "properties": {
    "contactId": {
      "id": "contactId",
      "type": "integer"
    },
    "firstName": {
      "id": "firstName",
      "type": "string"
    },
    "middleName": {
      "id": "middleName",
      "type": "string"
    },
    "lastName": {
      "id": "lastName",
      "type": "string"
    },
    "imageUrl": {
      "id": "imageUrl",
      "type": "string"
    },
    "companyId": {
      "id": "companyId",
      "type": "integer"
    },
    "companyName": {
      "id": "companyName",
      "type": "string"
    },
    "email": {
      "id": "email",
      "type": "string"
    },
    "emailValidationStatus": {
      "id": "emailValidationStatus",
      "type": "string"
    },
    "emails": {
      "id": "emails",
      "type": "array",
      "items": {
        "id": "0",
        "type": "object",
        "properties": {
          "email": {
            "id": "email",
            "type": "string"
          },
          "validationStatus": {
            "id": "validationStatus",
            "type": "string"
          }
        }
      }
    },
    "phone": {
      "id": "phone",
      "type": "string"
    },
    "description": {
      "id": "description",
      "type": "string"
    },
    "twitterHandle": {
      "id": "twitterHandle",
      "type": "string"
    },
    "facebookHandle": {
      "id": "facebookHandle",
      "type": "string"
    },
    "linkedinHandle": {
      "id": "linkedinHandle",
      "type": "string"
    },
    "age": {
      "id": "age",
      "type": "string"
    },
    "salary": {
      "id": "salary",
      "type": "string"
    },
    "salaryCurrency": {
      "id": "salaryCurrency",
      "type": "string"
    },
    "active": {
      "id": "active",
      "type": "boolean"
    },
    "jobLevels": {
      "id": "jobLevels",
      "type": "array",
      "items": [
        {
          "id": "0",
          "type": "string"
        }
      ]
    },
    "jobFunctions": {
      "id": "jobFunctions",
      "type": "array",
      "items": [
        {
          "id": "0",
          "type": "string"
        }
      ]
    },
    "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": {
      "id": "peopleId",
      "type": "string"
    },
    "fullName": {
      "id": "fullName",
      "type": "string"
    },
    "titles": {
      "id": "titles",
      "type": "array",
      "items": [
        {
          "id": "0",
          "type": "string"
        }
      ]
    },
    "confidenceScore": {
      "id": "confidenceScore",
      "type": "number"
    },
    "sources": {
      "id": "sources",
      "type": "array",
      "items": [
        {
          "id": "0",
          "type": "string"
        }
      ]
    },
    "education": {
      "id": "education",
      "type": "array",
      "items": {
        "id": "0",
        "type": "object",
        "properties": {
          "degree": {
            "id": "degree",
            "type": "string"
          },
          "major": {
            "id": "major",
            "type": "string"
          },
          "university": {
            "id": "university",
            "type": "string"
          }
        }
      }
    },
    "directPhone": {
      "id": "directPhone",
      "type": "string"
    },
    "corporatePhone": {
      "id": "corporatePhone",
      "type": "string"
    }
  }
}

Example

{
  "contactId": 6328347,
  "firstName": "Tim",
  "lastName": "Cook",
  "companyId": 1058007,
  "companyName": "Apple Computer UK",
  "phone": "+44 800 039 1010",
  "twitterHandle": "http://twitter.com/T_Cook",
  "facebookHandle": "http://www.facebook.com/135724710121292",
  "age": "54",
  "active": false,
  "email": "tcook@apple.com",
  "emailValidationStatus": "ValidEmail",
  "emails": [
  	{
  	  "email": "tcook@apple.com",
  	  "validationStatus": "ValidEmail"	
 	}
  ],
  "jobLevels": [
    "C Level"
  ],
  "jobFunctions": [
    "Other"
  ],
  "jobLevelsV2": [
        {
            "id": "0",
            "name": "Board Member"
        },
        {
            "id": "1",
            "name": "C Level"
        }
  ],
  "jobFunctionsV2": [
        {
            "id": "22",
            "name": "Others"
        }
  ],
  "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"
    }
  ],
  "confidenceScore": 0.86,
  "directPhone": "9876543210",
  "corporatePhone": "+44 800 039 1010",
  "sources": [
    "Web References",
    "Social Media",
    "InsideView",
    "Reuters",
    "Community"
  ],
  "titles": [
    "CEO, Apple Inc."
  ]
}

Type: application/xml

Schema:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

	<xs:element name="contact" type="fetchContactDTO" />

	<xs:element name="education" type="educationDTO" />
	<xs:element name="email" type="emailDTO" />

	<xs:complexType name="fetchContactDTO">
		<xs:sequence>
			<xs:element name="contactId" type="xs:int" minOccurs="0" />
			<xs:element name="educations" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="education" minOccurs="0" maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="companyId" type="xs:int" minOccurs="0" />
			<xs:element name="titles" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="title" type="xs:string" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="sources" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="source" type="xs:string" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="jobLevels" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="jobLevel" type="xs:string" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="jobFunctions" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="jobFunction" type="xs:string" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="jobLevelsV2" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="jobLevelV2" type="jobLevelsV2andjobFunctionsV2DTO" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="jobFunctionsV2" minOccurs="0">
				<xs:complexType>
					<xs:sequence>
						<xs:element name="jobFunctionV2" type="jobLevelsV2andjobFunctionsV2DTO" minOccurs="0"
							maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="active" type="xs:string" minOccurs="0" />
			<xs:element name="age" type="xs:string" minOccurs="0" />
			<xs:element name="companyName" type="xs:string" minOccurs="0" />
			<xs:element name="confidenceScore" type="xs:decimal" minOccurs="0" />
			<xs:element name="description" type="xs:string" minOccurs="0" />
			<xs:element name="email" type="xs:string" minOccurs="0" />
			<xs:element name="emailValidationStatus" type="xs:string" minOccurs="0" />
			<xs:element name="emails" minOccurs="0" >
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="email" minOccurs="0" maxOccurs="unbounded" />
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="facebookHandle" type="xs:string"
				minOccurs="0" />
			<xs:element name="firstName" type="xs:string" minOccurs="0" />
			<xs:element name="fullName" type="xs:string" minOccurs="0" />
			<xs:element name="imageUrl" type="xs:string" minOccurs="0" />
			<xs:element name="lastName" type="xs:string" minOccurs="0" />
			<xs:element name="linkedinHandle" type="xs:string"
				minOccurs="0" />
			<xs:element name="middleName" type="xs:string" minOccurs="0" />
			<xs:element name="peopleId" type="xs:string" minOccurs="1" maxOccurs="1" />
			<xs:element name="phone" type="xs:string" minOccurs="0" />
            <xs:element name="directPhone" type="xs:string" minOccurs="0" />
            <xs:element name="corporatePhone" type="xs:string" minOccurs="0" />
			<xs:element name="twitterHandle" type="xs:string"
				minOccurs="0" />
			<xs:element name="salary" type="xs:string" minOccurs="0"/>
			<xs:element name="salaryCurrency" type="xs:string" minOccurs="0"/>
		</xs:sequence>
	</xs:complexType>

	<xs:complexType name="educationDTO">
		<xs:sequence>
			<xs:element name="degree" type="xs:string" minOccurs="0" />
			<xs:element name="major" type="xs:string" minOccurs="0" />
			<xs:element name="university" type="xs:string" minOccurs="0" />
		</xs:sequence>
	</xs:complexType>
	<xs:complexType name="emailDTO">
		<xs:sequence>
			<xs:element name="email" type="xs:string" minOccurs="0" />
			<xs:element name="validationStatus" type="xs:string" minOccurs="0" />
		</xs:sequence>
	</xs:complexType>
	<xs:complexType name="jobLevelsV2andjobFunctionsV2DTO">
		<xs:sequence>
			<xs:element name="id" type="xs:string" minOccurs="1" maxOccurs="1"/>
			<xs:element name="name" type="xs:string" minOccurs="1" maxOccurs="1"/>
		</xs:sequence>
	</xs:complexType>
</xs:schema>

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>
    <jobLevelsV2>
        <jobLevelV2>
            <id>0</id>
            <name>Board Member</name>
        </jobLevelV2>
        <jobLevelV2>
            <id>1</id>
            <name>C Level</name>
        </jobLevelV2>
    </jobLevelsV2>
    <jobFunctionsV2>
        <jobFunctionV2>
            <id>22</id>
            <name>Others</name>
        </jobFunctionV2>
    </jobFunctionsV2>
    <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>
    <directPhone>9876543210</directPhone>
    <corporatePhone>+44 800 039 1010</corporatePhone>
    <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 404

Invalid ID, record not found.

HTTP 405

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

HTTP 429

Request is throttled.

[GET] - Contact Details

Endpoint

Request

HTTP Headers

URI Parameters

Query Parameters

Responses

HTTP 200

Type: application/json

Type: application/xml

HTTP 400

HTTP 401

HTTP 404

HTTP 405

HTTP 429

<%= previousTitle %>

<%= nextTitle %>

In this article

Additional Resources

<% if (block.html_url) { %> <%= block.name %> <% } else { %> <%= block.name %> <% } %>

Categories

Toggle navigation menu

<%= category.name %>