[GET] - People details API – InsideView

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 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 > 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.

Articles in this section

[GET] - People details API