PrintNowPrintNowDocs

Products

Download a product's Photo Merge renderings: realistic mockup images of the product, set up on the product in the admin.

  1. List the renderings for a product id (for example an order item's product_id). Each has an id and a name such as "Front View".
  2. Download one by its id. The response is the PNG image, sent as an attachment named after the rendering.

A product without renderings answers 404 on the list.

List a product's renderings

GET
/api/v2/product/{productId}/renderings
AuthorizationBasic <token>

Your API token as the username and your API key as the password.

In: header

Path Parameters

productId*integer

Product id (an order item's product_id).

Formatint32

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/product/0/renderings"
[
  {
    "id": 22,
    "name": "Front"
  },
  {
    "id": 23,
    "name": "Angled"
  },
  {
    "id": 24,
    "name": "ARView"
  }
]

The key or token is missing, does not match, or the token is inactive or deleted.

{
  "Message": "Invalid key or token."
}

The message names the section, e.g. Orders, Customers, Products, Storefronts, Reports or Webhooks.

{
  "Message": "Your license does not include the Orders API."
}
{
  "Message": "Product renderings not found."
}

Each license may make 100 calls per 10 seconds across all its API keys. Wait for the Retry-After header (seconds) before calling again.

{
  "Message": "Rate limit exceeded: 100 calls per 10 seconds."
}

Download a rendering image

GET
/api/v2/product/{productId}/renderings/{renderingId}
AuthorizationBasic <token>

Your API token as the username and your API key as the password.

In: header

Path Parameters

productId*integer

Product id.

Formatint32
renderingId*integer

Rendering id, from the product's rendering list.

Formatint32

Response Body

image/png

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/product/0/renderings/0"
"string"

The key or token is missing, does not match, or the token is inactive or deleted.

{
  "Message": "Invalid key or token."
}

The message names the section, e.g. Orders, Customers, Products, Storefronts, Reports or Webhooks.

{
  "Message": "Your license does not include the Orders API."
}
{
  "Message": "Product rendering not found."
}

Each license may make 100 calls per 10 seconds across all its API keys. Wait for the Retry-After header (seconds) before calling again.

{
  "Message": "Rate limit exceeded: 100 calls per 10 seconds."
}

On this page