[GET] - Person Details {deprecated}

  • Updated

Use the Person Details endpoint to fetch details about a person once you know its id. You can choose to retrieve all or some of the details of the person.

The person id can be obtained either through the Person API Person Search.

Endpoint

GET https://api.insideview.com/api/v1/person/{id}

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
id String Yes Person id

Query Parameters

Parameter Name Type Required Description
fields String No Comma separated list of fields to include in the response.  
Use this parameter if you are interested in only a few fields to reduce the amount of data retrieved.
Ex: fields=lastName,firstName,twitterHandle

Responses

HTTP 200

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

Name type Description
contactId Integer Contact InsideView ID
description String Contact bio
facebookHandle String Contact Facebook profile URL
firstName String Contact first name
imageUrl String Contact image URL
lastName String Contact last name
linkedHandle String Contact LinkedIn profile URL
twitterHandle String Contact Twitter profile URL
education Array Array of contact's education details
education degree String  
education  major String  
education university  String   
sources List List of sources for contact attributes (String)

application/json example

{
    "contactId":8802619,
    "firstName":"Umberto",
    "lastName":"Milletti",
    "imageUrl":"https://pbs.twimg.com/profile_images/303484549/Umberto_small_normal.jpg",
    "twitterHandle":"http://twitter.com/umbertom",
    "facebookHandle":"http://www.facebook.com/umbertom",
    "linkedInHandle":"http://www.linkedin.com/in/umbertom",
    "titles":[
        "Chief Executive Officer & Founder"
    ],
    "sources":[
        "User Generated",
        "Community",
        "Web References",
        "LinkSV",
        "InsideView",
        "Social Media"
    ]
}
    

application/xml example

<?xml version="1.0" encoding="UTF-8"?>
<person>
    <contactId>8802619</contactId>
    <facebookHandle>http://www.facebook.com/umbertom</facebookHandle>
    <firstName>Umberto</firstName>
    <imageUrl>https://pbs.twimg.com/profile_images/303484549/Umberto_small_normal.jpg</imageUrl>
    <lastName>Milletti</lastName>
    <linkedInHandle>http://www.linkedin.com/in/umbertom</linkedInHandle>
    <sources>
        <source>User Generated</source>
        <source>Community</source>
        <source>Web References</source>
        <source>LinkSV</source>
        <source>InsideView</source>
        <source>Social Media</source>
    </sources>
    <titles>
        <title>Chief Executive Officer &amp; Founder</title>
    </titles>
    <twitterHandle>http://twitter.com/umbertom</twitterHandle>
</person>

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.