---
title: "List Queues"
method: GET
path: "/v1/annotation-queues"
tags: ["Annotation Queues"]
---

# List Queues

`GET /v1/annotation-queues`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/annotation-queues`
- Auth: none declared. Required headers: `CONFIDENT_API_KEY`
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/annotation-queues/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves all annotation queues in your project with statistics and pagination support. Each queue includes completion metrics, item counts, and assignment breakdowns.

Filter results by queue type (TRACE, SPAN, THREAD, GOLDEN, TEST_RUN) or search by name. Queues are returned in descending order by creation date.

## Query parameters

- `page` integer
- `pageSize` integer
- `start` string, date-time
- `end` string, date-time
- `sortBy` 'createdAt'
- `ascending` 'true' | 'false'
- `type` 'TRACE' | 'SPAN' | 'THREAD' | 'GOLDEN' | 'TEST_RUN'
- `searchTerm` string

## Headers

- `CONFIDENT_API_KEY` string, required

## Response `200`

Successfully retrieved list of annotation queues

- ListAnnotationQueuesResponse
  - `success` boolean, required: Indicates if the request was successful.
  - `data` object, required
    - `annotationQueues` object[], required
      - `id` string: The unique identifier of the annotation queue.
      - `name` string: The name of the annotation queue.
      - `type` 'TRACE' | 'SPAN' | 'THREAD' | 'GOLDEN' | 'TEST_RUN': The type of items this queue contains.
      - `createdAt` string, date-time: The timestamp when the annotation queue was created.
      - `updatedAt` string, date-time: The timestamp when the annotation queue was last updated.
      - `completedItems` integer: The number of items in the queue that have been completed.
      - `totalItems` integer: The total number of items in the queue.
      - `completionPercentage` integer: The percentage of items completed in the queue (0-100).
    - `total` integer, required: The total number of annotation queues matching the filter criteria.
    - `limit` integer, required: The maximum number of annotation queues returned in this response.
    - `offset` integer, required: The number of annotation queues skipped in this response.

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-03-03** `ecbd18488092`: 2 breaking, 2 info
  - removed the enum value `asc` from the `query` request parameter `ascending`
  - removed the enum value `desc` from the `query` request parameter `ascending`
  - added the new enum value `false` to the `query` request parameter `ascending`
  - added the new enum value `true` to the `query` request parameter `ascending`

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/annotation-queues/get.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)