Skip to main content
GET
Get a queued pod

Authorizations

Authorization
string
header
required

Runpod API key authentication. Generate an API key in the Runpod console and send it in the Authorization header as Bearer <api_key>. Keys are scoped to the permissions granted when created; requests may return 403 when a valid key lacks access to the requested resource or action.

Console sessions (Clerk JWTs) act for the signed-in user. To act for a team instead, also send X-Team-Id: <team_id>; it applies only when the user owns or belongs to that team, otherwise the request runs against the user's own account. API keys created inside a team already act for that team and do not need the header.

Path Parameters

id
string
required

Queued pod identifier

Response

OK

A pod waiting for capacity, or the record of one that waited. It carries what identifies and schedules the request; the full container settings are not echoed back, keep your create request.

id
string
required
Example:

"clz1x9k4a0000qw3h8s7d2f1g"

status
enum<string>
required

Where a queued pod is in its life.

  • QUEUED — waiting for capacity (from queue.startsAt when set)
  • DEPLOYED — capacity came and a pod was created; podId names it
  • FAILED — capacity came but the deploy was refused for good; failureReason says why
  • EXPIRED — queue.expiresAt passed without capacity
  • CANCELLED — cancelled with DELETE /v2/queued-pods/{id}
Available options:
QUEUED,
DEPLOYED,
FAILED,
EXPIRED,
CANCELLED
podId
string | null
required

The pod created once capacity came; null until then. Read it with GET /v2/pods/{id}.

Example:

null

failureReason
enum<string> | null
required

Set only when status is FAILED.

Available options:
INSUFFICIENT_BALANCE,
SPENDING_LIMIT,
GPU_QUOTA_EXCEEDED,
GPU_CONCURRENCY_EXCEEDED,
ORG_RESTRICTED,
UNKNOWN
name
string
required

The name the pod will carry.

Example:

"pytorch-training"

image
string | null
required

The image the pod will run. Null when it comes from templateId at deploy time.

Example:

"runpod/pytorch:1.0.2-cu1281-torch280-ubuntu2404"

templateId
string | null
required

The template the scheduler resolves at deploy time. Null for queued pods from this API, which expands templateId into image when the request is made.

Example:

null

gpu
object
required
cloud
enum<string>
required

Cloud tier.

  • SECURE — Runpod-owned datacenter hardware
  • COMMUNITY — community-hosted hardware
Available options:
SECURE,
COMMUNITY
dataCenterIds
string[]
required

The data centers the deploy is limited to; empty when any will do.

Example:
queue
object
required

The queue options as stored, with the defaults applied.

createdAt
string<date-time>
required
Example:

"2026-06-01T12:00:00Z"

resolvedAt
string<date-time> | null
required

When the queued pod deployed, failed or expired. Null while it waits, and after a cancel.

Example:

null

Last modified on November 13, 2026