---
title: "getTaxonomyBulkActionJobById"
method: GET
path: "/v1/entity/taxonomies/bulk-jobs/{job_id}"
tags: ["Taxonomy"]
---

# getTaxonomyBulkActionJobById

`GET /v1/entity/taxonomies/bulk-jobs/{job_id}`

Gets a bulk action job by job id

## Path parameters

- `job_id` string, required

## Response `200`

Returns the job matching the given job id

- 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/8dd3d44e1c4f/schema)
