---
title: "Retrieve an annotation queue"
method: GET
path: "/v2/annotation-queues/{annotation_queue_id}"
tags: ["Annotation Queues"]
---

# Retrieve an annotation queue

`GET /v2/annotation-queues/{annotation_queue_id}`

Retrieves an existing annotation queue by ID.

## Path parameters

- `annotation_queue_id` string, required

## Response `200`

OK

- AnnotationQueue
  - `_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.

## Changes

> 261 revisions in range; 73 not diffed.

- **2026-09-01** `359a7831a2f0` — 6 breaking, 6 info
  - the `created` response's property type changed from no type to `string` for status `200`
  - the `created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - the `updated` response's property type changed from no type to `string` for status `200`
  - …8 more
- **2026-09-01** `66b8a4902911` — 7 breaking, 7 info
  - the response property `created_by_id` became nullable for the status `200`
  - the response property `updated_by_id` became nullable for the status `200`
  - the `created` response's property type changed from `string` to no type for status `200`
  - the `created_by_id` response's property type changed from `string` to `string, null`, and format from no format to `uuid` for status `200`
  - …10 more
- **2026-09-01** `081200e02fe0` — 6 breaking, 6 info
  - the `created` response's property type changed from no type to `string` for status `200`
  - the `created_by_id` response's property type changed from `string, null` to `string`, and format from `uuid` to no format for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - the `updated` response's property type changed from no type to `string` for status `200`
  - …8 more
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/annotation-queues/:annotation_queue_id/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/4a39391f62da/schema)