---
title: "List account artwork"
method: GET
path: "/api/image-generations/list"
tags: ["Artwork"]
---

# List account artwork

`GET /api/image-generations/list`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/image-generations/list`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.createprints.ai/api/oauth/authorize`, token URL `https://api.createprints.ai/api/oauth/token`, scopes: `artwork:read`)

Returns the authenticated account's artwork newest first. Set `purchasable=true` to retain only completed jobs with uploaded images. Private image paths are exposed only to the signed-in owner using a user-session token; API keys and MCP tokens receive `null`.

## Query parameters

- `limit` integer
- `cursor` string, date-time
- `purchasable` boolean

## Response `200`

A cursor-paginated artwork page.

- ArtworkList
  - `jobs` ArtworkListItem[], required
    - `jobId` string, uuid, required
    - `status` 'processing' | 'failed' | 'complete' | 'unknown', required
    - `purchasable` boolean, required
    - `title` string, nullable
    - `imagePaths` string[], nullable
    - `imagePrivate` boolean, required
    - `createdAt` string, date-time, required
  - `cursor` string, date-time, nullable, required

## Other responses

- `400`: Missing or invalid input.
- `401`: The credential is missing, invalid, revoked, or expired.
- `403`: The credential lacks the required scope or cannot perform this operation.
- `500`: Create Prints could not complete the request.

---

[API](https://skmtc.dev/createprints/apis/create-prints-api.md) · [All operations](https://skmtc.dev/createprints/apis/create-prints-api/llms.txt) · [OpenAPI document](https://skmtc.dev/createprints/apis/create-prints-api/revisions/05c57f496d51?raw)