---
title: "List purchasable physical print variants"
method: GET
path: "/api/agent-print-options"
tags: ["Product discovery"]
---

# List purchasable physical print variants

`GET /api/agent-print-options`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/agent-print-options`
- Auth: none required

Returns canonical `productVariantId` values, print dimensions, format, optional extras, compatible generation size, frame choices, product price, and a single-item postage estimate. That estimate is not final basket postage: checkout recalculates postage for quantity and multi-item baskets. Use `generation.imageModelSize` when creating artwork for the selected variant.

## Query parameters

- `country` 'GB' | 'US'

## Response `200`

Currently purchasable physical print variants.

- PrintOptions
  - `currency` 'GBP' | 'USD', required
  - `usage` string, required
  - `productVariants` ProductVariant[], required
    - `productVariantId` string, uuid, required
    - `productId` union, required
      - string
      - integer
    - `sku` string, nullable
    - `sizeOptionId` string, uuid, required: Legacy alias; use `productVariantId`.
    - `size` Option, required
      - `id` union, required
        - integer
        - string
      - `value` string, nullable, required
      - `name` string, required
    - `format` Option, required
      - `id` union, required
        - integer
        - string
      - `value` string, nullable, required
      - `name` string, required
    - `extra` Option, required
      - `id` union, required
        - integer
        - string
      - `value` string, nullable, required
      - `name` string, required
    - `generation` GenerationSpec, required
      - `aspect` 'square' | 'portrait' | 'landscape', required
      - `imageModelSize` string, required
      - `promptSizeId` 1 | 2 | 3, required
    - `requiresFrameOption` boolean, required
    - `frameOptions` Option[], required
      - `id` union, required
        - integer
        - string
      - `value` string, nullable, required
      - `name` string, required
    - `price` number, required
    - `priceFormatted` string, required
    - `shippingPrice` number, nullable, required
    - `shippingPriceFormatted` string, nullable, required
    - `estimatedCheckoutTotal` number, nullable, required
    - `estimatedCheckoutTotalFormatted` string, nullable, required
    - `shipping` object, required
      - `price` number, nullable, required
      - `priceFormatted` string, nullable, required
      - `includedInPrice` false, required
      - `note` string, required
    - `checkout` object, required
      - `productVariantId` string, uuid, required
      - `frameOptionId` string, nullable, required

## Other responses

- `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)