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

# getTaxonomyBulkActionJobById

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

## Request

- Base URL: `https://entity.sls.epilot.io`
- URL: `https://entity.sls.epilot.io/v1/entity/taxonomies/bulk-jobs/{job_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-epilot-org-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.dev/epilot/apis/entity-api.md) - [All operations](https://skmtc.dev/epilot/apis/entity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/epilot/apis/entity-api/revisions/b7d4f45d1518?raw)
