---
title: "Get an artwork job"
method: GET
path: "/api/image-generations"
tags: ["Artwork"]
---

# Get an artwork job

`GET /api/image-generations`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/image-generations`
- 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 processing state and print eligibility for one account-owned artwork. `purchasable` becomes true only after processing completes and an image is uploaded. For a private import, image paths are returned only to the signed-in owner using a user-session token and are null for account API keys and MCP access tokens.

## Query parameters

- `id` string, uuid, required

## Response `200`

Current artwork state and metadata.

- ArtworkStatus
  - `jobId` string, uuid, required
  - `id` string, uuid, required: Legacy alias of `jobId`.
  - `status` 'processing' | 'failed' | 'complete' | 'unknown', required
  - `statusCode` 1 | 2 | 3, required
  - `creditsRemaining` integer, required
  - `imageUploaded` boolean, required
  - `imagePaths` string[], nullable
  - `image_paths` string[], nullable
  - `imagePrivate` boolean, required
  - `visibility` string, nullable
  - `source` string, nullable
  - `purchasable` boolean, required
  - `aspect` 'square' | 'portrait' | 'landscape', required
  - `imageModelSize` string, required
  - `promptSize` integer, nullable
  - `title` string, nullable
  - `description` string, nullable
  - `originalPrompt` string, nullable
  - `revisedPrompt` string, nullable
  - `keywords` string[], nullable
  - `warnings` ImportWarning[]
    - `code` string, required
    - `severity` 'warning', required
    - `message` string, required
  - `artworkCheck` ArtworkCheck: Standalone-artwork classifier result; fields may expand.
    - `status` string
    - `warningCodes` string[]
    - `error` string, nullable
  - `colorScheme` ColorScheme, required: Persisted colour classification and affect analysis. Legacy palette fields retain their stored JSON value shapes.
    - `colorCategory` string, nullable
    - `colorPsychology` object, required
      - `impactLevel` string, nullable, required
      - `primaryTrait` string, nullable, required
    - `recommendedRoom` string, nullable
    - `colorPalette` unknown[], required
      - unknown
    - `dominantColor` unknown[], required
      - unknown
    - `vibrantColor` unknown[], required
      - unknown
    - `complementaryColors` unknown[], required
      - unknown
    - `affect` ColorAffect, required: Continuous mood and colour analysis generated from the artwork palette.
      - `arousal` number, required
      - `valence` number, required
      - `warmth` number, required
      - `complexity` number, nullable, required
      - `emotions` string[], required
      - `primaryTrait` string, required
      - `temperature` string, required
      - `energyLevel` string, required
      - `impactLevel` string, required
      - `harmony` object, required
        - `type` string, required
        - `hueClusters` integer, required
      - `rooms` object[], required
        - `room` string, required
        - `score` number, required
      - `recommendedRooms` string[], required
      - `rationale` string, 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.
- `404`: The resource was not found for the authenticated account.
- `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)