---
title: "Get job status"
method: GET
path: "/queue/status"
tags: ["Queue"]
---

# Get job status

`GET /queue/status`

Poll the current status of a previously submitted job. Provide the request_id and model as query parameters.

## Query parameters

- `request_id` string, required — Request ID returned from the submit endpoint
- `model` string, required — Model name the job was submitted to

## Response `200`

Status information

- QueueJobStatusResponse — Current status and metadata for a queued job.
  - `claimed_at` string, date-time — Timestamp when a worker claimed the job
  - `created_at` string, date-time — Timestamp when the job was created
  - `done_at` string, date-time — Timestamp when the job completed (done or failed)
  - `info` object — Job metadata. Contains keys from the submit request, plus any modifications from the model or system (e.g. progress, retry history).
  - `inputs` object — Freeform model input, as submitted
  - `model` string, required — Model identifier the job was submitted to
  - `outputs` object — Freeform model output, populated when the job reaches done status. Contents are model-specific.
  - `priority` integer — Job priority. Higher values are processed first.
  - `request_id` string, required — The request ID that was returned from the submit endpoint
  - `retries` integer — Number of times this job has been retried. Workers set a claim timeout and must send periodic status updates to keep the job alive. If no update is received within the timeout, the job is returned to the queue and retried. After 3 retries the job is permanently failed. Jobs explicitly failed by the model are not retried.
  - `status` 'pending' | 'running' | 'done' | 'failed' | 'canceled', required — Current job status. Transitions: pending → running → done/failed. A pending job may also be canceled.
  - `warnings` string[] — Non-fatal messages about the request (e.g. deprecation notices)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Request not found
- `500` — Internal server error

---

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