[GET] - People details API

Use the People Details endpoint to fetch details about a person once you know its peopleId. This peopleId will also return all the current and past employments(contacts). You can choose to retrieve all or some of the details of the employment.

The people id can be obtained either through the Data API Contact Search or Target Contact List Build API.

Endpoint

GET https://api.insideview.com/api/v1/people/{peopleId}

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
peopleId	String	Yes	People ID

Query Parameters

Parameter Name	Type	Required	Description
active	Boolean	No	Set to "TRUE" to get only current employments
page	Integer	No	Page number
resultsPerPage	Integer	No	Number of results per page

Responses

HTTP 200

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

Name	type	Description
peopleId	String	People Id of the person
firstName	String	Person's first name
middleName	String	Person's middle name
lastName	String	Person's last name
fullName	String	Person's full name
education	Array	Array of contact's education details
education degree	String
education major	String
education university	String
imageUrl	String	Contact image URL
facebookHandle	String	Contact Facebook profile URL
linkedinHandle	String	Contact LinkedIn profile URL
twitterHandle	String	Contact Twitter profile URL
age	String	Age
peopleCountry	String	Country name
peopleState	String	State name
peopleCity	String	City name
peopleArea	String	Area name
peopleAddress	String	Address
latitude	String
longitude	String
employments	Array	Array of employments
employments companyId	Integer	Contact's company InsideView ID
employments companyName	String	Contact's company name
employments contactId	Integer	Contact InsideView ID
employments description	String	Contact bio
employments email	String	Contact email address
employments titles	List	List of contact's titles (String)
employments phone	String	Phone number
employments active	Boolean	Active / inactive employment flag
employments jobLevelsV2	Array	An array of a newer version of the job levels
employment jobFunctionsV2	Array	An array of a newer version of the job functions
employments jobLevels	Array	An array of job levels
employments jobFunctions	Array	Array of job functions
employments salary	String	Salary
employments salaryCurrency	String	Salary Currency
employments startDate	String	Employment start date
employments endDate	String	Employment end date

Type: application/json

Schema

{
"id":"/",
"type":"object",
"properties":{
"peopleId":{
"id":"peopleId",
"type":"string"
},
"firstName":{
"id":"firstName",
"type":"string"
},
"middleName":{
"id":"middleName",
"type":"string"
},
"lastName":{
"id":"lastName",
"type":"string"
},
"fullName":{
"id":"fullName",
"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"
}
}
}
},
"imageUrl":{
"id":"imageUrl",
"type":"string"
},
"twitterHandle":{
"id":"twitterHandle",
"type":"string"
},
"facebookHandle":{
"id":"facebookHandle",
"type":"string"
},
"linkedinHandle":{
"id":"linkedinHandle",
"type":"string"
},
"peopleCountry":{
"id":"country",
"type":"string"
},
"peopleCity":{
"id":"city",
"type":"string"
},
"peopleArea":{
"id":"area",
"type":"string"
},
"peopleState":{
"id":"state",
"type":"string"
},
"peopleAddress":{
"id":"address",
"type":"string"
},
"latitude":{
"id":"latitude",
"type":"string"
},
"longitude":{
"id":"longitude",
"type":"string"
},
"age":{
"id":"age",
"type":"string"
},
"employments":{
"id":"employments",
"type":"array",
"items":{
"id":"0",
"type":"object",
"properties":{
"startDate": {
"id": "startDate",
"type": "string"
},
"endDate": {
"id": "endDate",
"type": "string"
},
"contactId":{
"id":"contactId",
"type":"integer"
},
"titles":{
"id":"titles",
"type":"array",
"items":[
{
"id":"0",
"type":"string"
}
]
},
"companyName":{
"id":"companyName",
"type":"string"
},
"active":{
"id":"active",
"type":"boolean"
},
"description":{
"id":"description",
"type":"string"
},
"companyId":{
"id":"companyId",
"type":"integer"
},
"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"
}
}
}
},
"confidenceScore":{
"id": "confidenceScore",
"type": "number"
},
"phone":{
"id":"phone",
"type":"string"
},
"salary":{
"id":"salary",
"type":"string"
},
"salaryCurrency":{
"id":"salaryCurrency",
"type":"string"
},
"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"
}
}
}
}
}
}
}
}
}

Example

{
  "peopleId": "IDivDfKDNZlvpSQVZ2EixMGSzJ__LggG05M8iRkhE4SSaeWUeA_bL-7Dy9FDn5Uv",
  "firstName": "Paul",
  "middleName": "St",
  "lastName": "John",
  "fullName": "Paul St John",
  "facebookHandle": "http://www.facebook.com/100000330275490",
  "linkedinHandle": "http://www.linkedin.com/in/paulstjohn",
  "peopleCountry": "United States",
  "peopleArea": "San Francisco Bay Area",
  "peopleState": "CA",
  "peopleAddress": "San Francisco Bay Area",
  "latitude": "37.71476746",
  "longitude": "-122.2422333",
  "age": 0,
  "employments": [
    {
      "contactId": 90266693,
      "titles": [
        "Sales Director"
      ],
      "companyName": "Dell EMC",
      "active": false,
      "companyId": 725270,
      "jobLevels": [
        "Director"
      ],
      "jobFunctions": [
        "Sales"
      ],
      "jobLevelsV2": [
          {
            "id": "0",
            "name": "Board Member"
          },
          {
            "id": "1",
            "name": "C Level"
          }
       ],
       "jobFunctionsV2": [
          {
            "id": "22",
            "name": "Others"
          }
       ]
    },
    {
      "contactId": 90266638,
      "confidenceScore": 0.71,
      "email": "paul@github.com",
      "emailValidationStatus": "ValidDomain",
      "emails": [
  	    {
  	      "email": "paul@github.com",
  	      "validationStatus": "ValidDomain"	
 	    }
  	  ],
      "titles": [
        "VP WW Sales"
      ],
      "companyName": "GitHub Inc.",
      "active": true,
      "companyId": 2676964,
      "jobLevels": [
        "Vice President"
      ],
      "jobFunctions": [
        "Sales"
      ]
    },
    {
      "contactId": 13646638,
      "titles": [
        "Vice President of Worldwide Sales"
      ],
      "companyName": "Alfresco Software, Ltd.",
      "active": false,
      "companyId": 721258,
      "jobLevels": [
        "Vice President"
      ],
      "jobFunctions": [
        "Sales"
      ],
      "jobLevelsV2": [
          {
            "id": "0",
            "name": "Board Member"
          },
          {
            "id": "1",
            "name": "C Level"
          }
       ],
       "jobFunctionsV2": [
          {
            "id": "22",
            "name": "Others"
          }
       ]
    },
    {
      "contactId": 90266673,
      "titles": [
        "Strategic Account Manager"
      ],
      "companyName": "Oracle Corporation",
      "active": false,
      "companyId": 726579,
      "jobLevels": [
        "Other"
      ],
      "jobFunctions": [
        "Sales",
        "Operations and Administration"
      ]
    },
    {
      "contactId": 90266652,
      "titles": [
        "Regional Director"
      ],
      "companyName": "Riverbed Technology, Inc.",
      "active": false,
      "companyId": 737866,
      "jobLevels": [
        "Director"
      ],
      "jobFunctions": [
        "Other"
      ],
      "jobLevelsV2": [
          {
            "id": "0",
            "name": "Board Member"
          },
          {
            "id": "1",
            "name": "C Level"
          }
       ],
       "jobFunctionsV2": [
          {
            "id": "22",
            "name": "Others"
          }
       ]
    }
  ]
}

Type: application/xml

Schema

<xs:schema attributeFormDefault="unqualified"
	elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
	<xs:element name="email" type="emailDTO" />
	<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:element name="people">
		<xs:complexType>
			<xs:sequence>
				<xs:element type="xs:string" name="peopleAddress" />
				<xs:element type="xs:int" name="age" />
				<xs:element name="educations">
					<xs:complexType>
						<xs:sequence>
							<xs:element name="education" maxOccurs="unbounded"
								minOccurs="0">
								<xs:complexType>
									<xs:sequence>
										<xs:element type="xs:string" name="degree" />
										<xs:element type="xs:string" name="major" />
										<xs:element type="xs:string" name="university" />
									</xs:sequence>
								</xs:complexType>
							</xs:element>
						</xs:sequence>
					</xs:complexType>
				</xs:element>
				<xs:element type="xs:string" name="peopleArea" />
				<xs:element type="xs:string" name="peopleCity" />
				<xs:element type="xs:string" name="peopleCountry" />
				<xs:element name="employments">
					<xs:complexType>
						<xs:sequence>
							<xs:element name="employment" maxOccurs="unbounded"
								minOccurs="0">
								<xs:complexType>
									<xs:sequence>
										<xs:element name="confidenceScore" type="xs:decimal" 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 type="xs:string" name="active" />
										<xs:element type="xs:int" name="companyId" />
										<xs:element type="xs:string" name="companyName" />
										<xs:element type="xs:int" name="contactId" />
										<xs:element type="xs:string" name="description" />
                                                                                <xs:element type="xs:string" name="startDate" />
                                                                                <xs:element type="xs:string" name="endDate" />										<xs:element name="jobFunctions">
											<xs:complexType>
												<xs:sequence>
													<xs:element type="xs:string" name="jobFunction" />
												</xs:sequence>
											</xs:complexType>
										</xs:element>
										<xs:element name="jobLevels">
											<xs:complexType>
												<xs:choice maxOccurs="unbounded" minOccurs="0">
													<xs:element type="xs:string" name="jobLevel" />
												</xs:choice>
											</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 type="xs:string" name="salary"
											minOccurs="0" />
										<xs:element type="xs:string" name="salaryCurrency"
											minOccurs="0" />
										<xs:element name="titles">
											<xs:complexType>
												<xs:sequence>
													<xs:element type="xs:string" name="title" />
												</xs:sequence>
											</xs:complexType>
										</xs:element>
									</xs:sequence>
								</xs:complexType>
							</xs:element>
						</xs:sequence>
					</xs:complexType>
				</xs:element>
				<xs:element type="xs:string" name="facebookHandle" />
				<xs:element type="xs:string" name="firstName" />
				<xs:element type="xs:string" name="fullName" />
				<xs:element type="xs:string" name="lastName" />
				<xs:element type="xs:string" name="middleName" />
				<xs:element type="xs:string" name="latitude" />
				<xs:element type="xs:string" name="linkedinHandle" />
				<xs:element type="xs:string" name="longitude" />
				<xs:element type="xs:string" name="peopleId" />
				<xs:element type="xs:string" name="peopleState" />
			</xs:sequence>
		</xs:complexType>
	</xs:element>
</xs:schema>

Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<people>
    <age>0</age>
    <employments>
        <employment>
            <active>false</active>
            <companyId>725270</companyId>
            <companyName>Dell EMC</companyName>
            <contactId>90266693</contactId>
            <jobFunctions>
                <jobFunction>Sales</jobFunction>
            </jobFunctions>
            <jobLevels>
                <jobLevel>Director</jobLevel>
            </jobLevels>
            <titles>
                <title>Sales Director</title>
            </titles>
        </employment>
        <employment>
            <active>true</active>
            <companyId>2676964</companyId>
            <companyName>GitHub Inc.</companyName>
            <contactId>90266638</contactId>
            <confidenceScore>0.71</confidenceScore>
            <email>paul@github.com</email>
    		<emailValidationStatus>ValidDomain</emailValidationStatus>
    		<emails>
    			<email>
    				<email>paul@github.com</email>
    				<validationStatus>ValidDomain</validationStatus>
    			</email>
    		</emails>
            <jobFunctions>
                <jobFunction>Sales</jobFunction>
            </jobFunctions>
            <jobLevels>
                <jobLevel>Vice President</jobLevel>
            </jobLevels>
            <titles>
                <title>VP WW Sales</title>
            </titles>
        </employment>
        <employment>
            <active>false</active>
            <companyId>721258</companyId>
            <companyName>Alfresco Software, Ltd.</companyName>
            <contactId>13646638</contactId>
            <jobFunctions>
                <jobFunction>Sales</jobFunction>
            </jobFunctions>
            <jobLevels>
                <jobLevel>Vice President</jobLevel>
            </jobLevels>
            <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>
            <titles>
                <title>Vice President of Worldwide Sales</title>
            </titles>
        </employment>
        <employment>
            <active>false</active>
            <companyId>726579</companyId>
            <companyName>Oracle Corporation</companyName>
            <contactId>90266673</contactId>
            <jobFunctions>
                <jobFunction>Sales</jobFunction>
                <jobFunction>Operations and Administration</jobFunction>
            </jobFunctions>
            <jobLevels>
                <jobLevel>Other</jobLevel>
            </jobLevels>
            <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>
            <titles>
                <title>Strategic Account Manager</title>
            </titles>
        </employment>
        <employment>
            <active>false</active>
            <companyId>737866</companyId>
            <companyName>Riverbed Technology, Inc.</companyName>
            <contactId>90266652</contactId>
            <jobFunctions>
                <jobFunction>Other</jobFunction>
            </jobFunctions>
            <jobLevels>
                <jobLevel>Director</jobLevel>
            </jobLevels>
            <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>
            <titles>
                <title>Regional Director</title>
            </titles>
        </employment>
    </employments>
    <facebookHandle>http://www.facebook.com/100000330275490</facebookHandle>
    <firstName>Paul</firstName>
    <fullName>Paul St John</fullName>
    <lastName>John</lastName>
    <latitude>37.71476746</latitude>
    <linkedinHandle>http://www.linkedin.com/in/paulstjohn</linkedinHandle>
    <longitude>-122.2422333</longitude>
    <middleName>St</middleName>
    <peopleAddress>San Francisco Bay Area</peopleAddress>
    <peopleArea>San Francisco Bay Area</peopleArea>
    <peopleCountry>United States</peopleCountry>
    <peopleId>IDivDfKDNZlvpSQVZ2EixMGSzJ__LggG05M8iRkhE4SSaeWUeA_bL-7Dy9FDn5Uv</peopleId>
    <peopleState>CA</peopleState>
</people>

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.

[GET] - People details API

Endpoint

Request

HTTP Headers

URI Parameters

Query Parameters

Responses

HTTP 200

Type: application/json

Type: application/xml

Example

HTTP 400

HTTP 401

HTTP 405

HTTP 404

HTTP 429

<%= previousTitle %>

<%= nextTitle %>

In this article

Additional Resources

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

Categories

Toggle navigation menu

<%= category.name %>