[POST] - Target Company Insights Installed Tech Job

  • Updated

Use this endpoint to submit a bulk request of Target Company Installed Tech Details queries. It creates an asynchronous job on InsideView servers. See Using the Bulk APIs for more details.

The company ids can be obtained through the Target API Company List Endpoint.

POST https://api.insideview.com/api/v1/target/companies/techProfile/job

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).
Accept-Language String No Select the response's language and locale.
Default value: en-en
See Internationalization Support for more details.
Content-Type String No Input content type
application/octet-stream or text/plain

Query Parameters

Parameter Name Type Required Description
webhook String No URL for receiving Job status

 

Request Body

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

Example input data

84OKnj1c07bdsDwj8_O4ZHqpHFcAIJQVdw1sczYgi_P3IDQTZ-e_DGORXj4V5MhD
NZ30nmuF51Z7fsFoZ149FDMYzsVPFZhftV_NPzgl8Kx-KHLSPu0_mSiSvzdLxnMQ
1WhHImR7pXLvHsM8ffnIoWK5s_zgcOqCZyhUv7NmkRgC44OZZGkhYVcaFopQQfhk
RtAQCfBKDqHDOghtle5Wmw_1r-D_OQtmLSMgIfQSAbcvEnQVZaGopyLYZEvHNRNU
d19oY8bwn5MwYVdk07mKNGf-uSGSYMWWhIuZASFECKaLMaIkPt2FgVlhHMIfQlbq

Responses

Here are the major responses the API may return.

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": "targetTechProfileFetch"
}

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>81g8d74jjo8s4grarkii</jobId>
    <status>accepted</status>
    <type>targetTechProfileFetch</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.