---
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.

## Path parameters

- `annotation_queue_id` string, required

## Query parameters

- `limit` integer — A limit on the number of objects to be returned. Limit can range between 1 and 200, and the default is 10
- `starting_after` string — A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list.
- `ending_before` string — A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list.

## Response `200`

Annotation queue items retrieved.

- object
  - `object` 'list', required
  - `data` union[], required
    - union
      - object
        - `_id` string, required
        - `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
        - `span_id` string, required
        - `trace_id` string — The trace identifier this span belongs to
        - `type` 'span', required
      - object
        - `_id` string, required
        - `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
        - `datapoint_id` string, required
        - `type` 'datapoint', required
  - `has_more` boolean, required

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/6a22c53a2580/schema)