Articles in this section

See more

[GET] - People details API

Nitin Singh Sisodia
  • Updated
Follow

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.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk