---
title: "List Bulkjobs for Token"
method: GET
path: "/kg/v3/enhance/bulk/status"
tags: ["Bulk Enhance"]
---

# List Bulkjobs for Token

`GET /kg/v3/enhance/bulk/status`

Poll the status of all Enhance Bulkjobs for a token

## Response `200`

Success status

- BulkjobStatus[]
  - `job_id` string — Bulkjob Id
  - `name` string — Bulkjob name
  - `refresh` boolean — Is Refresh enabled for this job?
  - `search` 'ON' | 'OFF' | 'SEARCHONLY' | 'FALLBACK' — Is Search enabled for this job?
  - `message` string — Bulkjob status message
  - `jobs_total` integer — Number of jobs in bulkjob
  - `jobs_completed` integer — Number of jobs completed in bulkjob.
  - `status` 'NOT_STARTED' | 'IN_PROCESS' | 'COMPLETE' | 'COMPLETE_WITH_FAILURES' | 'STOPPED' | 'ERROR_FINALIZING' | 'ERROR_SCHEDULING' | 'UNKNOWN' — Status of Bulkjob. One of {NOT_STARTED, IN_PROCESS, COMPLETE, COMPLETE_WITH_FAILURES, STOPPED, ERROR_FINALIZING, UNKNOWN}
  - `estimate_remaining_time` integer — Estimated remaining time for bulkjob to complete (in seconds). `null` if job is completed or not started.
  - `submit_time_ms` integer — Bulkjob submit time
  - `start_time_ms` integer — Bulkjob start time
  - `completed_time_ms` integer — Bulkjob completed time
  - `total_results` integer — Total results
  - `bulkjobId` string
  - `totalJobs` integer
  - `finishedJobs` integer
  - `estimateRemainingTimeSec` integer
  - `submitTimeMs` integer
  - `startTimeMs` integer
  - `completedTimeMs` integer
  - `totalResults` integer
  - `fileSizeBytes` integer — Size of download file in bytes
  - `reports` Report[] — Coverage reports generated for this bulkjob
    - `reportId` string — Coverage Report ID
    - `status` 'NOT_STARTED' | 'IN_PROCESS' | 'COMPLETE' | 'COMPLETE_WITH_FAILURES' | 'STOPPED' | 'ERROR_FINALIZING' | 'ERROR_SCHEDULING' | 'UNKNOWN' — Status of report generation. One of {NOT_STARTED, IN_PROCESS, COMPLETE, UNKNOWN}
    - `format` string — Export format
    - `spec` string — The spec defines the columns to export. This is applicable for csv, xls and xslx formats.<br><br>Export spec specifies how to export the entity JSON to a csv. A simple export spec looks like `name;summary`. To specify more complex export spec, including specifying how many of a list of `industries` to return, or the ideal `employment` record, see [Exporting Columnar Format](https://docs.diffbot.com/reference/exporting-csv) and [JsonPath Filtering](https://docs.diffbot.com/docs/en/filtering-fields).
    - `exportfile` string
    - `exportSeparator` string — Separator for multi-value fields when exporting columnar results
    - `filter` string — Semi-colon separated path filter to filter response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as such as `$.name;$.locations.country.name`. For more advanced options, see [JsonPath Filtering](https://docs.diffbot.com/reference/filtering-fields) for syntax.
    - `onlyMatches` boolean — Return only records that have a match

## Other responses

- `401` — Token not specified or other client errors
- `500` — Internal Server Error

---

[API](https://skmtc.net/diffbot/apis/web-search.md) · [All operations](https://skmtc.net/diffbot/apis/web-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/diffbot/web-search/versions/8b88d7dabe63/schema)