Products

The Products endpoints let you retrieve photo-realistic rendering images for products that have Photo Merge renderings configured. These are pre-rendered mockup images showing the product with customer designs applied.

Endpoints

Method	Endpoint	Description
`GET`	`/api/v2/product/{productId}/renderings`	List available renderings for a product
`GET`	`/api/v2/product/{productId}/renderings/{renderingId}`	Download a rendering image

List Renderings

Retrieve the list of available rendering images for a product. Only returns results for products with Photo Merge renderings configured.

GET /api/v2/product/{productId}/renderings

Example Request

curl -X GET https://api.printnow.com/api/v2/product/42/renderings \
  -u "YOUR_TOKEN:YOUR_KEY"

Example Response

[
  { "id": 1, "name": "Front View" },
  { "id": 2, "name": "Back View" },
  { "id": 3, "name": "Perspective" }
]

Rendering Fields

Field	Type	Description
`id`	integer	Rendering ID. Use this to download the rendering image.
`name`	string	Rendering name (e.g., "Front View", "Perspective").

Returns 404 Not Found if the product does not exist or has no renderings configured.

Download Rendering

Download a specific rendering image as a PNG file.

GET /api/v2/product/{productId}/renderings/{renderingId}

Parameters

Name	Type	Location	Description
`productId`	integer	path	Product ID.
`renderingId`	integer	path	Rendering ID from the List Renderings response.

Returns the rendering image as image/png with a Content-Disposition attachment header. Returns 404 Not Found if the product, rendering, or image file does not exist.

Example Request

curl -X GET https://api.printnow.com/api/v2/product/42/renderings/1 \
  -u "YOUR_TOKEN:YOUR_KEY" \
  --output front-view.png

Error Responses

Code	Message	Cause
`404`	`Product renderings not found.`	The product does not exist or has no Photo Merge renderings configured.
`404`	`Product rendering not found.`	The specified rendering ID does not exist for this product.

Orders — order line items reference product IDs returned by this endpoint
Products — configure products and Photo Merge renderings in the admin UI

Products

On this page