---
title: "Annotation Queue Items Query"
method: POST
path: "/annotation_queues/{queue_id}/items/query"
tags: ["Annotation Queues"]
---

# Annotation Queue Items Query

`POST /annotation_queues/{queue_id}/items/query`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/annotation_queues/{queue_id}/items/query`
- Auth: none declared

Query items in an annotation queue with pagination and sorting.

## Path parameters

- `queue_id` string, required

## Request body

- AnnotationQueueItemsQueryBody: Request body for querying items in an annotation queue (queue_id comes from path).
  - `project_id` string, required
  - `filter` AnnotationQueueItemsFilter: Simple filter for annotation queue items. Supports equality filtering on call metadata fields and IN filtering on annotation state.
    - `id` string, nullable: Filter by exact queue item ID
    - `call_id` string, nullable: Filter by exact call ID
    - `call_op_name` string, nullable: Filter by exact operation name
    - `call_trace_id` string, nullable: Filter by exact trace ID
    - `added_by` string, nullable: Filter by W&B user ID who added the call
    - `annotation_states` string[], nullable: Filter by annotation states (unstarted, in_progress, completed, skipped)
  - `sort_by` SortBy[], nullable: Sort by multiple fields (e.g., created_at, updated_at)
    - `field` string, required
    - `direction` 'asc' | 'desc', required
  - `limit` integer, nullable
  - `offset` integer, nullable
  - `include_position` boolean: Include position_in_queue field (1-based index in full queue)

## Response `200`

Successful Response

- AnnotationQueueItemsQueryRes: Response from querying annotation queue items.
  - `items` AnnotationQueueItemSchema[], required
    - `id` string, required
    - `project_id` string, required
    - `queue_id` string, required
    - `call_id` string, required
    - `call_started_at` string, date-time, required
    - `call_ended_at` string, date-time, nullable
    - `call_op_name` string, required
    - `call_trace_id` string, required
    - `display_fields` string[], required
    - `added_by` string, nullable
    - `annotation_state` 'unstarted' | 'in_progress' | 'completed' | 'skipped', required
    - `annotator_user_id` string, nullable
    - `created_at` string, date-time, required
    - `created_by` string, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
    - `position_in_queue` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `dd89fadfe4e4`: 4 info
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the new optional request property `filter/anyOf[subschema #1: AnnotationQueueItemsFilter]/id`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-29** `13059f956116`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/annotation_queues/:queue_id/items/query/post.md)

---

[API](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api.md) - [All operations](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/revisions/f7643c49bf2e?raw)