---
title: "List the account's items (newest first, cursor-paginated)"
method: GET
path: "/v1/items"
tags: ["items"]
---

# List the account's items (newest first, cursor-paginated)

`GET /v1/items`

## Request

- Base URL: `https://pixeloa.ai`
- URL: `https://pixeloa.ai/v1/items`
- Auth: HTTP bearer

Query: limit (1–100, default 25), cursor (created_at ISO string from next_cursor), status.

## Response `200`

OK

- Item
  - `id` string, uuid
  - `title` string
  - `description` string, nullable
  - `status` 'draft' | 'analyzing' | 'awaiting_confirmation' | 'confirmed' | 'generating' | 'ready' | 'failed'
  - `visibility` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `dimensions_cm` object
    - `confirmed` object, nullable
    - `estimated` object, nullable
  - `model` object
    - `available` boolean
    - `sha256` string, nullable
  - `public` object
    - `published` boolean
    - `slug` string, nullable
    - `ar_url` string, uri, nullable
    - `embed_url` string, uri, nullable
  - `publishable` object: Row-level pre-check for POST /publish; POST /publish reports the exact resolver state on 409.
    - `ok` boolean
    - `blockers` string[]
  - `next_allowed_actions` string[]

## Other responses

- `401`: Error envelope
- `403`: Error envelope
- `404`: Error envelope
- `409`: Error envelope
- `422`: Error envelope
- `429`: Error envelope

---

[API](https://skmtc.dev/pixeloa/apis/pixeloa-api.md) · [All operations](https://skmtc.dev/pixeloa/apis/pixeloa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixeloa/apis/pixeloa-api/revisions/10a8178bed64?raw)