Skip to main content
GET
/
queue
/
status
cURL
curl -X GET "https://api.together.ai/v1/queue/status?request_id=019ba379-92da-71e4-ac40-d98059fd67c7&model=my-org/video-generator" \
  -H "Authorization: Bearer $TOGETHER_API_KEY"
{
  "request_id": "019ba379-92da-71e4-ac40-d98059fd67c7",
  "model": "my-org/video-generator",
  "status": "done",
  "outputs": {
    "video_url": "https://api.together.ai/storage/019ba379-output.mp4"
  },
  "info": {
    "user_id": "user_123",
    "progress": 1
  },
  "priority": 1,
  "created_at": "2026-02-07T10:30:00Z",
  "claimed_at": "2026-02-07T10:30:02Z",
  "done_at": "2026-02-07T10:31:45Z"
}

Authorizations

​
Authorization
string
header
default:default
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
request_id
string
required

Request ID returned from the submit endpoint

​
model
string
required

Model name the job was submitted to

Response

Status information

​
model
string
required

Model identifier the job was submitted to

​
request_id
string
required

The request ID that was returned from the submit endpoint

​
status
enum<string>
required

Current job status. Transitions: pending → running → done/failed. A pending job may also be canceled.

Available options:
pending,
running,
done,
failed,
canceled
​
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

​
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.

​
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.

​
warnings
string[]

Non-fatal messages about the request (e.g. deprecation notices)