---
title: "getTaxonomyBulkActionJobs"
method: GET
path: "/v1/entity/taxonomies/bulk-jobs"
tags: ["Taxonomy"]
---

# getTaxonomyBulkActionJobs

`GET /v1/entity/taxonomies/bulk-jobs`

Gets bulk actions jobs by job status:
- <undefined> = all active jobs
- PENDING = all active jobs
- FAILED = all failed jobs
- COMPLETED = all completed jobs

## Query parameters

- `status` string[] — A comma separated list of job statuses to return
- `size` number — The maximum number of jobs to return (defaults to 20)
- `created_after` string, date-time — ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).
- `sort_pending_first` boolean — When true, sorts PENDING status jobs to the top of the results.
- `scope` 'me' | 'all' — Scope of jobs to return. 'me' returns only jobs created by the current user, 'all' returns jobs from all users in the organization.

## Response `200`

Returns the jobs matching the given query or the active jobs if no status is provided

- TaxonomyBulkJob[]
  - `job_id` string, uuid
  - `job_status` 'PENDING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' — The status of the bulk job
  - `failure_reason` string
  - `action_type` 'MOVE_CLASSIFICATIONS' | 'MERGE_CLASSIFICATIONS' | 'DELETE_CLASSIFICATIONS'
  - `request` object
    - `target_taxonomy` string — URL-friendly name for taxonomy
    - `target_classification` string
    - `classification_ids` ClassificationId[]
  - `output` object
    - `target_entities_count` number
    - `affected_entities_count` number
    - `failures_count` number
    - `failed_entities` EntityId[]
  - `created_by` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `org` string

---

[API](https://skmtc.net/epilot/apis/entity-api.md) · [All operations](https://skmtc.net/epilot/apis/entity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/entity-api/revisions/3020984570dc/schema)