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

# Query items from an annotation queue

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

Queries items from the specified annotation queue. Items whose span no longer exists are skipped.

## Path parameters

- `annotation_queue_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

OK

- ListAnnotationQueueItemsResponse
  - `object` string, required — Object discriminator for list responses; always `list`.
  - `data` AnnotationQueueItem[], required — Page of annotation queue items.
    - `_id` string, required — Unique annotation queue item identifier assigned by ORQ.
    - `annotation_queue_id` string, required — The unique identifier of the annotation queue.
    - `workspace_id` string, required — The unique identifier of the workspace it belongs to.
    - `used_human_review_ids` string[] — The unique identifiers of the human reviews that have been used to annotate the item.
    - `type` string, required — The item type. Either `span` or `datapoint`.
    - `span_id` string — The span this item points to. Present when `type` is `span`.
    - `trace_id` string — The trace identifier this span belongs to.
    - `datapoint_id` string — The datapoint this item points to. Present when `type` is `datapoint`.
  - `has_more` boolean, required — Whether more items are available in the selected pagination direction.

## Changes

> 261 revisions in range; 73 not diffed.

- **2026-09-01** `359a7831a2f0` — 3 breaking, 10 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/` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/datapoint_id` to the response with the `200` status
  - …9 more
- **2026-09-01** `66b8a4902911` — 7 breaking, 7 warning, 1 info
  - for the `query` request parameter `limit`, default value `10` was added
  - added `subschema #1, subschema #2` to the `data/items/` response property `oneOf` list for the response status `200`
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/_id` from the response with the `200` status
  - …11 more
- **2026-09-01** `081200e02fe0` — 3 breaking, 10 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/` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/datapoint_id` to the response with the `200` status
  - …9 more
- …earlier changes not shown

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