---
title: "Get a Queue"
method: GET
path: "/v2/queues/{queueName}"
tags: ["Queues"]
---

# Get a Queue

`GET /v2/queues/{queueName}`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/queues/{queueName}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/qstash-rest-api/docs/v2/queues/:queueName/get.ts> (a function with typed inputs; its response is checked against the schema)

Get details of a specific queue

## Path parameters

- `queueName` string, required

## Response `200`

- Queue
  - `name` string: The name of the queue.
  - `createdAt` integer: The creation timestamp of the queue in Unix milliseconds
  - `updatedAt` integer: The last update timestamp of the queue in Unix milliseconds
  - `parallelism` integer: The number of parallel consumers consuming from the queue
  - `paused` boolean: Whether the queue is paused
  - `lag` integer: The number of unprocessed messages that exist in the queue

## Other responses

- `400`: Queue name is invalid. Queue names can only contain alphanumeric characters, hyphens, periods, and underscores.
- `404`: Queue not found

---

[API](https://skmtc.dev/upstash/apis/qstash-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/qstash-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/qstash-rest-api/revisions/0c3b83ef4770?raw)