[POST] - Asynchronous (batch) Target Contact List Build API

Use this endpoint to build a list a contacts using rich filters in batch mode.

The elements in the contact list contain a newid value and enough additional information such that a user could narrow down a selection from the list. Using the selected newid values you can retrieve additional contact information through the Target API's New Contact Details endpoint.

Endpoint

POST https://api.insideview.com/api/v1/target/contacts/export/job

Request

HTTP Headers

Form Parameters

Responses

Here are the major responses the API may return.

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

For details on the errors, see API Error Codes.

HTTP 200

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

Type: application/json

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "type": "object",
  "properties": {
    "jobId": {
      "id": "jobId",
      "type": "string"
    },
    "status": {
      "id": "status",
      "type": "string"
    },
    "type": {
      "id": "type",
      "type": "string"
    }
  }
}

Example

{
  "jobId": "lnjkd7ie0hblp1k58e5q",
  "status": "accepted",
  "type": "targetContactSearchAsyncExport"
}

Type: application/xml

Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="BulkJobStatus" type="BulkJobStatusDTO"/>
    <xs:complexType name="BulkJobStatusDTO">
        <xs:sequence>
            <xs:element name="jobId" type="xs:string" />
            <xs:element name="status" type="xs:string" />
            <xs:element name="type" type="xs:string" />     
        </xs:sequence>
    </xs:complexType>
</xs:schema>

Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BulkJobStatus>
    <jobId>s04eabq2bt0ncgpa1095</jobId>
    <status>accepted</status>
    <type>targetContactSearchAsyncExport</type>
</BulkJobStatus>

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 429

Request is throttled.