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

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

---

[API](https://skmtc.net/wandb/apis/serverless-training.md) · [All operations](https://skmtc.net/wandb/apis/serverless-training/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandb/serverless-training/versions/8d8d96fc0fd3/schema)