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 peopleId can be obtained either through the Data API Contact Search.
Endpoint
GET https://api.insideview.com/api/v1/people/{peopleId}
Request
HTTP Headers
| Header Name | Type | Required | Description |
| accessToken | String | Yes |
Valid access token. |
| 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 > jobLevels | Array | Array of Job levels |
| employments > jobFunctions | Array | Array of job functions |
| employments > salary | String | Salary |
| employments > salaryCurrency | String | Salary Currency |
application/json 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"
]
},
{
"contactId": 90266638,
"email": "paul@github.com",
"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"
]
},
{
"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"
]
}
]
}
application/xml 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> <email>paul@github.com</email> <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> <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> <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> <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.