[POST] - New Contact Details Job

Use the New Contact Job endpoint to submit a bulk of New Contact Details queries.  It creates an asynchronous job on InsideView servers.  Refer to Using the bulk API article for more details.

Endpoint

POST https://api.insideview.com/api/v1/target/contact/job

Request

HTTP Headers

Query Parameters

Request Body

The request body should contain a list of new contact ids, either separated with a new line.  The request can contain up to 10,000 new contact ids.  

Example input data

TpK9Pfj0reHRDsBKLsm9QdvBF4RUQqmNaLvYlh8Qcxshb1LDCdjfrnlT9cZEKsoP
TpK9Pfj0reHRDsBKLsm9Qc6anwTUlcMWZ7ad_M6EwCJHQrLbtTZQNsOh-SGmVMMb
TpK9Pfj0reHRDsBKLsm9QcR1zbxfug8J67sSP63tRymPHslL1Uzgvjs1f5OvA3ku

Responses

Here are the major responses the API may return.

This API returns email validation status in a .CSV response file, which you can download.

for details on the errors, please refer to the API Error Codes article.

HTTP 200

An HTTP 200 status means the data have been accepted and a job have been queued.

application/json example response

{
  jobId: "peerukbkasr85s6hdtb9"
  status: "accepted"
  type: "targetContactDetails"
}

application/json example response

<?xml version="1.0" encoding="UTF-8"?>
<BulkJobStatus>
 <jobId>a8bpdds1one7vblg0obm</jobId>
 <status>accepted</status>
 <type>targetContactDetails</type>
</BulkJobStatus>

HTTP 400

An HTTP 400 error code may have several causes:

• Validation of input data failed
• Insufficient transaction quota available
• Too many job submitted to the processing queue
• etc.

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 415

The Content-Type mandatory is not valid, please refer to the API documentation.

HTTP 429

Request is throttled.