---
title: "Get a queued job"
method: GET
path: "/shop/queued-jobs/{queuedJobId}"
tags: ["Meta"]
---

# Get a queued job

`GET /shop/queued-jobs/{queuedJobId}`

Returns the status and output of a Trybe-internal background job
that was previously kicked off via a queue-issuing endpoint (e.g.
`queueExport`, `queueImportVouchers`, the practitioner-occupancy
queue endpoints, voucher-code bulk creation).

Poll this endpoint to watch a job progress from `pending` →
`in_progress` → `complete`/`failed`. Once `status` is `complete`,
`output` contains the per-job result envelope (a list of created
records, a signed download URL, error rows, etc., depending on the
job).

Requires the `view` ability on the `QueuedJob` — typically granted
to the user who originally enqueued the job.

## Response `200`

The job was successfully queued

- object
  - `data` QueuedJob, required
    - `id` string, uuid, required — The ID of the queued job.
    - `status` 'pending' | 'complete' | 'failed', required — The status of the queued job.
    - `output` object, required — The output of the queued job.
    - `created_at` string, date-time, required — The date and time the queued job was created.
    - `updated_at` string, date-time, required — The date and time the queued job was last updated.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)