Use the Company Family Tree Job Status to retrieve the status of a job submitted previously.
Endpoint
GET https://api.insideview.com/api/v1/company/familyTree/job/{jobId}
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). |
URI Parameters
Parameter Name | Type | Required | Description |
jobId | String | Yes | Job ID |
Responses
Here are the major responses the API may return.
For details on the errors, see API Error Codes.
HTTP 200
Returns either a JSON or XML data structure depending on the request Accept header.
application/json Example
{ "jobId":"ado2umlpg5c2gef2qc2g", "status":"finished", "totalProcessed":3, "type":"familyTree" }
application/xml Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BulkJobStatus> <jobId>ado2umlpg5c2gef2qc2g</jobId> <status>finished</status> <totalProcessed>3</totalProcessed> <type>familyTree</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 404
Invalid ID, record not found.
HTTP 429
Request is throttled.