Use the Contact Details endpoint to fetch details about a contact once you know its id. You can choose to retrieve all or some of the details of the contact.
The contact id can be obtained either through the Data API Contact Search or through the Enrich API Enrich (or its bulk version).
Endpoint
GET https://api.insideview.com/api/v1/contact/{contactId}
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 |
contactId | String | Yes | Contact 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 |
companyId | Integer | Contact's company InsideView ID |
companyName | String | Contact's company name |
contactId | Integer | Contact InsideView ID |
description | String | Contact bio |
String | Contact email address | |
facebookHandle | String | Contact Facebook profile URL |
firstName | String | Contact first name |
lastName | String | Contact last name |
fullName | String | Contact full name |
imageUrl | String | Contact image URL |
linkedinHandle | String | Contact LinkedIn profile URL |
phone | String | Contact phone number |
confidenceScore | String | The min or maximum confidence score for a contact's email |
emailValidationStatus | String | Return the validation status of the email. Such as ValidEmail or ValidDomain |
twitterHandle | String | Contact Twitter profile URL |
education | Array | Array of contact's education details |
education > degree | String | |
education > major | String | |
education > university | String | |
titles | List | List of contact's titles (String) |
Confidence Score | Double | A percentage score based on Last validated date, Recency, Source, and Popularity |
sources | List | List of sources for contact attributes (String) |
active | Boolean | Active / inactive employment flag |
jobLevels | Array | Array of Job levels |
jobFunctions | Array | Array of job functions |
peopleId | String | People Id |
age | String | Age |
salary | String | Salary |
salaryCurrency | String | Salary Currency |
phoneType | String | Returns CORPORATE and DIRECT phone number of an executive. |
application/json example
{ "contactId": 6328347, "firstName": "Tim", "lastName": "Cook", "companyId": 1058007, "companyName": "Apple Computer UK", "phone": "+44 800 039 1010",
"corporate": +44 800 039 1010",
"direct":+939 4321 3433,
"confidenceScore": 0.86, "twitterHandle": "http://twitter.com/T_Cook", "facebookHandle": "http://www.facebook.com/135724710121292", "age": "54", "active": false, "jobLevels": [ "C Level" ], "jobFunctions": [ "Other" ], "peopleId": "ZWUf25_lqO7SY_AEoCa9H23wj0W_7eCqHbJO3nw_7gcFrg2vQ0LZ2iS0pCse8MlD", "fullName": "Tim Cook", "education": [ { "degree": "Bachelor of Science", "major": "Industrial Engineering", "university": "Auburn University" }, { "degree": "Masters of Business Administration", "major": "", "university": "Duke University" } ], "sources": [ "Web References", "Social Media", "InsideView", "Reuters", "Community" ], "titles": [ "CEO, Apple Inc." ] }
application/xml example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <contact> <contactId>6328347</contactId> <educations> <education> <degree>Bachelor of Science</degree> <major>Industrial Engineering</major> <university>Auburn University</university> </education> <education> <degree>Masters of Business Administration</degree> <major></major> <university>Duke University</university> </education> </educations> <companyId>1058007</companyId> <titles> <title>CEO, Apple Inc.</title> </titles> <sources> <source>Web References</source> <source>Social Media</source> <source>InsideView</source> <source>Reuters</source> <source>Community</source> </sources> <jobLevels> <jobLevel>C Level</jobLevel> </jobLevels> <jobFunctions> <jobFunction>Other</jobFunction> </jobFunctions> <active>false</active> <age>54</age> <companyName>Apple Computer UK</companyName>
<confidenceScore>0.86</confidenceScore>
<email>tcook@apple.com</email>
<emailValidationStatus>ValidEmail</emailValidationStatus>
<emails>
<email>
<email>tcook@apple.com</email>
<ValidationStatus>ValidEmail</ValidationStatus>
</email>
</emails> <facebookHandle>http://www.facebook.com/135724710121292</facebookHandle> <firstName>Tim</firstName> <fullName>Tim Cook</fullName> <lastName>Cook</lastName> <peopleId>ZWUf25_lqO7SY_AEoCa9H23wj0W_7eCqHbJO3nw_7gcFrg2vQ0LZ2iS0pCse8MlD</peopleId> <phone>+44 800 039 1010</phone>
<phoneType>+44 800 039 1010</phoneType> <twitterHandle>http://twitter.com/T_Cook</twitterHandle> </contact>
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.
Comments
0 comments
Please sign in to leave a comment.