---
title: "List the caller's print requests"
method: GET
path: "/api/prints/list"
tags: ["prints"]
---

# List the caller's print requests

`GET /api/prints/list`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/prints/list`
- Auth: HTTP bearer

Clerk session or agt_ token with `prints:read` (ft-member+). Newest first. Farm managers (operator tier or the farm-crew allowlist) may pass `queue=1` for the whole farm queue — open requests only unless `include_closed=1`. The response always carries `is_manager`.

## Query parameters

- `queue` '1'
- `include_closed` '1'
- `limit` integer

## Response `200`

Print requests.

- PrintsListResponse
  - `ok` boolean, required
  - `count` integer, required
  - `requests` PrintRequestPublic[], required
    - `id` string, required: pj_*
    - `status` 'pending' | 'accepted' | 'printing' | 'ready' | 'collected' | 'rejected' | 'canceled', required
    - `title` string, required
    - `details` string
    - `material` string
    - `color` string
    - `quantity` integer
    - `file` object, nullable: Vault file holding the model, or null for a link-only ask.
    - `link_url` string, nullable: Hosted-model URL, or null.
    - `submitted_by` string, required: Clerk user id.
    - `submitted_by_name` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `history` object[], required
    - `slice_status` string: Auto-slice outcome. Absent means slicing was never attempted.
  - `is_manager` boolean, required: True iff the caller may drive the farm queue (operator or farm crew).

## Other responses

- `401`: No auth.
- `403`: Scope/tier not authorized, or queue=1 from a non-manager.
- `500`: Read failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)