[POST] - Bulk Contact Fetch API

  • Updated

Use the Bulk Contact Fetch endpoint to retrieve contact details. You can pass a maximum of 50 contactIds to retrieve their details.

Endpoint

POST https://api.insideview.com/api/v1/contact/bulk

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).  
Content-Type String Yes  Application/JSON

Request Body

The request body should contain an array of contact ids in JSON format separated with commas. The request can contain up to 50 contact ids.  

Note: Bulk Contact Fetch APIs accept only “contactIds" array. If you enter duplicate IDs only one ID is accepted. If you enter Alphanumeric IDs, an invalid error is returned. If the Company IDs are not present in the database, the “company not present” error appears.

Example input data

{
    "contactIds": ["16935075", "16935075", "27964628", "4055734", "9879814", "56778f", "hdhujdj"]
}

 

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
email 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
jobLevelsV2 Array An array of a newer version of the job levels
jobFunctionsV2 Array An array of a newer version of the job functions
jobLevels Array An array of job levels
jobFunctions Array An 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.

Note: The Direct phone number is only available for InsideView customers and not OEM partners.

application/json example

 
  
  [
    {
        "requestedContactId": "16935075",
        "contact": {
            "contactId": 16935075,
            "firstName": "Satya",
            "lastName": "Nadella",
            "imageUrl": "https://pbs.twimg.com/profile_images/1221837516816306177/_Ld4un5A.jpg",
            "companyId": 4055734,
            "companyName": "Pensions & Investments Group",
            "email": "snadella@pionline.com",
            "emailValidationStatus": "ValidEmail",
            "phone": "+1 212 210 0100",
            "twitterHandle": "http://twitter.com/satyanadella",
            "age": "53",
            "active": true,
            "peopleId": "GZ2OaOPeGBU6r7zpZNalqPH3x_u0EXHw1laO0cyU3oy6Xywe6RokPiHKn09joKJW",
            "fullName": "Satya  Nadella",
            "confidenceScore": 0.8,
            "corporatePhone": "+1 212 210 0100",
            "sources": [
                "InsideView"
            ],
            "titles": [
                "CEO"
            ],
            "emails": [
                {
                    "email": "snadella@pionline.com",
                    "validationStatus": "ValidEmail"
                }
            ]
        }
    },
    {
        "requestedContactId": "27964628",
        "contact": {
            "contactId": 27964628,
            "firstName": "satya",
            "lastName": "Nadella",
            "imageUrl": "https://pbs.twimg.com/profile_images/1221837516816306177/_Ld4un5A.jpg",
            "companyId": 726263,
            "companyName": "Microsoft Corporation",
            "phone": "+1 425 882 8080",
            "twitterHandle": "http://twitter.com/satyanadella",
            "active": true,
            "peopleId": "Eul9Pskiz6dMjmxsBRV6XIqdMmHGWOFiW6XVlLt3rEXQsK-WUOidJY956KhNTdur",
            "fullName": "satya Nadella",
            "corporatePhone": "+1 425 882 8080",
            "sources": [
                "Community"
            ],
            "titles": [
                "Chief Executive Officer"
            ]
        }
    },
    {
        "requestedContactId": "4055734",
        "error": {
            "errorCode": "404-602",
            "errorMessage": "contact not found."
        }
    },
    {
        "requestedContactId": "9879814",
        "contact": {
            "contactId": 9879814,
            "firstName": "Bala",
            "lastName": "Nadella",
            "companyId": 1289414,
            "companyName": "Aditya Birla Minacs IT Services Limited",
            "phone": "91 80 6616 8000",
            "age": "40",
            "active": true,
            "jobLevels": [
                "Other"
            ],
            "jobFunctions": [
                "IT & IS"
            ],
            "jobLevelsV2": [
          {
            "id": "0",
            "name": "Board Member"
          },
          {
            "id": "1",
            "name": "C Level"
          }
       ],
       "jobFunctionsV2": [
          {
            "id": "22",
            "name": "Others"
          }
       ]
    },
    {
            "peopleId": "Qs-W_Rp2u-z_NEoHL7TEIFYi82GUO-ljiHpy_R-RjybvmmjQ7xjet8E3wj9Men8p",
            "fullName": "Bala  Nadella",
            "corporatePhone": "91 80 6616 8000",
            "sources": [
                "InsideView"
            ],
            "titles": [
                "Practice Head of ERP"
            ]
        }
    },
    {
        "requestedContactId": "56778f",
        "error": {
            "errorCode": "400-110",
            "errorMessage": "Contact id is not valid."
        }
    },
    {
        "requestedContactId": "hdhujdj",
        "error": {
            "errorCode": "400-110",
            "errorMessage": "Contact id is not valid."
        }
    }
]

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contactResponseDTOes>
<contactDetail>
<contact>
<titles>
<title>CEO</title>
</titles>
<emails>
<email>
<email>snadella@pionline.com</email>
<validationStatus>ValidEmail</validationStatus>
</email>
</emails>
<sources>
<source>InsideView</source>
</sources> 
<active>true</active>
<age>53</age>
<companyId>4055734</companyId>
<companyName>Pensions &amp; Investments Group</companyName>
<confidenceScore>0.8</confidenceScore>
<contactId>16935075</contactId>
<corporatePhone>+1 212 210 0100</corporatePhone>
<email>snadella@pionline.com</email>
<emailValidationStatus>ValidEmail</emailValidationStatus>
<firstName>Satya</firstName>
<fullName>Satya Nadella</fullName>
<imageUrl>https://pbs.twimg.com/profile_images/1221837516816306177/_Ld4un5A.jpg</imageUrl>
<lastName>Nadella</lastName>
<peopleId>GZ2OaOPeGBU6r7zpZNalqPH3x_u0EXHw1laO0cyU3oy6Xywe6RokPiHKn09joKJW</peopleId>
<phone>+1 212 210 0100</phone>
<twitterHandle>http://twitter.com/satyanadella</twitterHandle>
</contact><requestedContactId>16935075</requestedContactId>
</contactDetail><contactDetail><contact>
<titles><title>Chief Executive Officer</title></titles>
<sources>
<source>Community</source>
</sources>
<active>true</active>
<companyId>726263</companyId>
<companyName>Microsoft Corporation</companyName>
<contactId>27964628</contactId>
<corporatePhone>+1 425 882 8080</corporatePhone>
<firstName>satya</firstName>
<fullName>satya Nadella</fullName>
<imageUrl>https://pbs.twimg.com/profile_images/1221837516816306177/_Ld4un5A.jpg</imageUrl>
<lastName>Nadella</lastName>
<peopleId>Eul9Pskiz6dMjmxsBRV6XIqdMmHGWOFiW6XVlLt3rEXQsK-WUOidJY956KhNTdur</peopleId>
<phone>+1 425 882 8080</phone>
<twitterHandle>http://twitter.com/satyanadella</twitterHandle>
</contact>
<requestedContactId>27964628</requestedContactId>
</contactDetail><contactDetail>
<error>
<errorCode>404-602</errorCode>
<errorMessage>contact not found.</errorMessage>
</error>
<requestedContactId>4055734</requestedContactId>
</contactDetail><contactDetail>
<contact><titles>
<title>Practice Head of ERP</title></titles>
<sources>
<source>InsideView</source>
</sources>
<jobLevelsV2>
<jobLevelV2>
<id>0</id>
<name>Board Member</name>
</jobLevelV2>
</jobLevelsV2>
<jobLevelsV2>
<jobLevelV2>
<id>1</id>
<name>C Level</name>
</jobLevelV2>
</jobLevelsV2>
<jobFunctionsV2>
<jobFunctionV2>
<id>2</id>
<name>Other</name>
</jobFunctionV2>
</jobFunctionsV2> 
<jobLevels><jobLevel>Other</jobLevel>
</jobLevels><jobFunctions>
<jobFunction>IT &amp; IS</jobFunction></jobFunctions>
<active>true</active>
<age>40</age>
<companyId>1289414</companyId>
<companyName>Aditya Birla Minacs IT Services Limited</companyName>
<contactId>9879814</contactId>
<corporatePhone>91 80 6616 8000</corporatePhone>
<firstName>Bala</firstName>
<fullName>Bala Nadella</fullName>
<lastName>Nadella</lastName>
<peopleId>Qs-W_Rp2u-z_NEoHL7TEIFYi82GUO-ljiHpy_R-RjybvmmjQ7xjet8E3wj9Men8p</peopleId>
<phone>91 80 6616 8000</phone>
</contact>
<requestedContactId>9879814</requestedContactId>
</contactDetail>
<contactDetail>
<error>
<errorMessage>Contact id is not valid.</errorMessage>
</error>
</contactDetail>
<contactDetail>
<error>
<errorCode>400-110</errorCode>
<errorMessage>Contact id is not valid.</errorMessage>
</error>
<requestedContactId>hdhujdj</requestedContactId>
</contactDetail>
</contactResponseDTOes>

HTTP 400

Contact Id is not valid.

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in the header.

HTTP 405

Method Not Allowed - HTTP method other than POST is not allowed.

HTTP 404

Invalid ID, record not present. Contact not present.

HTTP 429

Request is throttled.

 

Was this article helpful?

0 out of 0 found this helpful