[GET] - People details API

  • Updated

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.

 

Was this article helpful?

0 out of 0 found this helpful