---
title: "Get the next or previous item in the queue."
method: GET
path: "/model-hub/annotation-queues/{queue_id}/items/next-item/"
tags: ["model-hub"]
---

# Get the next or previous item in the queue.

`GET /model-hub/annotation-queues/{queue_id}/items/next-item/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/model-hub/annotation-queues/{queue_id}/items/next-item/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Query params:
  exclude: comma-separated item IDs to skip
  before:  item ID — returns the item immediately before this one in order
  review_status: optional review status filter (for reviewer queues)
  exclude_review_status: optional review status to omit (for annotator queues)
  include_completed: when true, navigation can visit completed items too

## Query parameters

- `page` integer
- `limit` integer
- `exclude` string
- `before` string, uuid
- `review_status` string
- `exclude_review_status` string
- `include_completed` boolean
- `view_mode` string
- `include_all_annotations` boolean

## Response `200`

OK

- QueueNextItemResponse
  - `status` boolean
  - `result` QueueNextItemResult, required
    - `item` object, nullable, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)