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

# List annotation queues

`GET /v2/annotation-queues`

Returns annotation queues in the workspace, newest first.

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string
- `search` string
- `updated_by` string

## Response `200`

OK

- ListAnnotationQueuesResponse
  - `object` string, required — Object discriminator for list responses; always `list`.
  - `data` AnnotationQueue[], required — Page of annotation queues.
    - `_id` string, required — Unique annotation queue identifier assigned by ORQ.
    - `display_name` string, required — The display name of the annotation queue.
    - `description` string, required — The description of the annotation queue.
    - `workspace_id` string, required — The unique identifier of the workspace it belongs to.
    - `project_id` string — The project ID. When set, human reviews are resolved from the project automatically.
    - `human_review_ids` string[], required — Legacy: manually selected human review IDs. Used only when project_id is not set.
    - `metadata` AnnotationQueueMetadata, required — Aggregate counters maintained by the service as items are added and removed.
      - `items_count` integer, required — Number of items currently in the annotation queue.
    - `created_by_id` string — The account that created the annotation queue. Unset when created via API key authentication.
    - `updated_by_id` string — The account that last updated the annotation queue. Unset when updated via API key authentication.
    - `created` string, date-time — The date and time the annotation queue was created.
    - `updated` string, date-time — The date and time the annotation queue was last updated.
  - `has_more` boolean, required — Whether more annotation queues are available in the selected pagination direction.

## Changes

> 271 revisions in range; 82 not diffed.

- **2026-09-01** `359a7831a2f0` — 8 breaking, 7 info
  - for the `query` request parameter `limit`, default value `10` was removed
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - the `data/items/created` response's property type changed from no type to `string` for status `200`
  - the `data/items/created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - …11 more
- **2026-09-01** `66b8a4902911` — 8 breaking, 3 warning, 8 info
  - for the `query` request parameter `limit`, default value `10` was added
  - the response property `data/items/created_by_id` became nullable for the status `200`
  - the response property `data/items/updated_by_id` became nullable for the status `200`
  - the `data/items/created` response's property type changed from `string` to no type for status `200`
  - …15 more
- **2026-09-01** `081200e02fe0` — 8 breaking, 7 info
  - for the `query` request parameter `limit`, default value `10` was removed
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - the `data/items/created` response's property type changed from no type to `string` for status `200`
  - the `data/items/created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/annotation-queues/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/3df7b466d7e5/schema)