---
title: "List annotation queue items"
method: GET
path: "/api/v1/platform/annotation-queues/{queue_id}/items"
tags: ["annotation_queues"]
---

# List annotation queue items

`GET /api/v1/platform/annotation-queues/{queue_id}/items`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/platform/annotation-queues/{queue_id}/items`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

List RUN and THREAD items in a single annotation queue for one review status section, with opaque cursor pagination. Optional item_type=RUN|THREAD filters the page. Optional min_start_time/max_start_time bound the item's trace start time; items with no start time are excluded when either bound is set. direction=backward returns items before the supplied cursor. The response contains item metadata only, not expanded run or thread payloads. status=archived returns items whose queue review requirements have been satisfied, not merely items the caller personally marked completed.

## Path parameters

- `queue_id` string, required

## Query parameters

- `status` 'needs_my_review' | 'needs_others_review' | 'archived', required
- `page_size` integer
- `cursor` string
- `item_type` 'RUN' | 'THREAD'
- `min_start_time` string, date-time
- `max_start_time` string, date-time
- `direction` 'forward' | 'backward'

## Response `200`

OK

- AnnotationqueuesListAnnotationQueueItemsResponse
  - `items` AnnotationqueuesAnnotationQueueListItem[]
    - `added_at` string
    - `completed_by` string[]
    - `effective_added_at` string
    - `id` string
    - `item_type` 'RUN' | 'THREAD'
    - `last_reviewed_time` string: LastReviewedTime is always present on the wire (null until reviewed).
    - `project_id` string
    - `queue_id` string
    - `reserved_by` string[]
    - `run_id` string
    - `source_proposed_example_id` string
    - `start_time` string
    - `thread_id` string
  - `next_cursor` string
  - `previous_cursor` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/platform/annotation-queues/:queue_id/items/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)