[POST] - New Company Details Job


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


POST https://api.insideview.com/api/v1/target/company/fetch/job


HTTP Headers

Header Name
accessToken String Y Valid access token. 
See Authentication and Authorization Overview for more details.
Accept String No Precise the content type for the response.  
Valid values are application/json and application/xml (default).  
Accept-Language String No


Example: nl_NL,fr_FR,es_ES,de_DE,en_IE,en_GB,en_US

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 new company ids, either separated with a new line.  The request can contain up to 10,000 new company ids.

Example input data



Here are the major responses the API may return.

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: "targetCompanyDetails"

application/json example response

<?xml version="1.0" encoding="UTF-8"?>

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.


Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk