---
title: "Get an asynchronous job"
method: GET
path: "/async-jobs/{job_id}"
tags: ["AsynchronousJob"]
---

# Get an asynchronous job

`GET /async-jobs/{job_id}`

Fetches jobs

## Path parameters

- `job_id` string, required

## Response `200`

Job retrieved successfully

- AsynchronousJob — An AsynchronousJob to track and provide insight into long-running background job
  - `id` string — Unique identifier of the TestCase
  - `workspace_id` string — Unique identifier for the associated Workspace
  - `job_type` 'xray_sync' | 'workspace_copy' — Type of AsynchronousJob
  - `status` 'pending' | 'running' | 'completed' | 'failed' — Current status of the AsynchronousJob
  - `associated_entities` AsynchronousJobAssociatedEntity[] — Type of Entity this AsynchronousJob is associated with
    - `type` 'workspace' | 'plan_run' — Type of Entity this AsynchronousJob is associated with
    - `id` string — Unique identifier for the associated Entity
  - `created_time` integer — Time the AsynchronousJob was created
  - `created_by_id` string — Identifier of the user who created the AsynchronousJob
  - `last_updated_time` integer — Time the AsynchronousJob was last updated
  - `last_updated_by_id` string — Identifier of the user who last updated the AsynchronousJob
  - `error_message` string — If failed, an optional error message associated with the failure
  - `job_source` 'test_run' | 'plan_run' — What triggered this job

## Other responses

- `401` — User not authenticated
- `403` — User not authorized
- `404` — Entity not found
- `default` — Unknown error

---

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