---
title: "List Items in a Partition"
method: POST
path: "/v1/storage.items-list"
tags: ["Querator V1"]
---

# List Items in a Partition

`POST /v1/storage.items-list`

List items in a queue partition

## Request body

- StorageItemsListRequest
  - `queue_name` string, required
  - `partition` integer, required
  - `pivot` string, required
  - `limit` integer, required

## Response `200`

- StorageItemsListResponse
  - `items` StorageItem[], required
    - `id` string, required
    - `is_leased` boolean, required
    - `lease_deadline` string, date-time, required — The deadline when the lease expires and item becomes available again
    - `dead_deadline` string, date-time, required — The deadline when this item will be moved to dead letter queue
    - `expire_deadline` string, date-time, required — The deadline when this item expires and moves to dead letter queue
    - `created_at` string, date-time, required — The timestamp when this item was created
    - `updated_at` string, date-time, required — The timestamp when this item was last updated
    - `enqueue_at` string, date-time, required — The timestamp when this item should be enqueued for processing
    - `attempts` integer, required
    - `max_attempts` integer, required
    - `reference` string, required
    - `encoding` string, required
    - `kind` string, required
    - `payload` string, byte, required — The payload as base64-encoded bytes

## Changes

- **2026-07-17** `b67c2fa641f7` — 1 info
  - endpoint added
- **2024-09-15** `ba3240950bb2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/kapetan-io/apis/querator-api/changes/v1/storage.items-list/post.md)

---

[API](https://skmtc.dev/kapetan-io/apis/querator-api.md) · [All operations](https://skmtc.dev/kapetan-io/apis/querator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kapetan-io/querator-api/revisions/b67c2fa641f7/schema)