PrintNowPrintNowDocs

Orders

Read orders, download their print files, and update their shipping and status.

An order holds the customer, billing and shipping addresses, payment details, line items (each with its selected options), shipments and the storefront's custom checkout fields. Find order ids with the storefront order search, or receive them through the order_created and order_updated webhooks.

Each item's print-ready file is produced by a merge step after the order is placed. Download the files as zips:

DownloadContains
Order filesEvery item's print files (order-{orderId}.zip).
Item filesOne item's print files (item-{itemId}.zip).
Item assetsOne item's source files: the customer's uploads for a custom-design product, or the high-resolution images used in an editor design (item-assets-{itemId}.zip).

Until the files are ready, the order and item downloads answer 409 Conflict with a Retry-After header (60 seconds for an order, 30 for an item). Wait that long and try again.

Shipments and split shipping

Every order has at least one shipment. When a customer splits an order across addresses, there is one shipment per address, each with its own carrier, service, charges, tracking numbers and shipped date. Each item's shipment_index says which shipment it belongs to. The order-level shipping_address, shipping_provider and shipping_service describe the primary shipment; shipping_total is the shipping charge for the whole order (the sum over all shipments).

  • Mark an order shipped ships every item and every shipment.
  • Mark an item shipped ships that item and its shipment only, so you can ship one destination of a split order at a time.

Both use the storefront's shipped status (the status that sends the "Order Shipped" email), send that email to the customer, and add any tracking number you pass. A storefront without a shipped status answers 400.

Statuses

Set any status configured on the storefront by name (case-insensitive), for a whole order or one item. List a storefront's statuses with the Storefronts section's status list. Each change adds an order history entry with your comments and initials, noted "Updated via API". You choose whether to email the customer and the vendors (both off by default). Setting the shipped status also records the shipped date.

Shipping and status changes fire the order_updated webhook.

Get an order

GET
/api/v2/order/{orderId}
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/order/0"
{
  "storefront": "Demo Store",
  "id": 1053,
  "is_archived": false,
  "is_deleted": false,
  "integration_id": null,
  "status": "Beginning",
  "customer": {
    "storefront": "Demo Store",
    "storefront_id": 1,
    "id": 24,
    "first_name": "Demo",
    "last_name": "User",
    "email": "demo.user@domain.com",
    "username": "demouser",
    "receive_marketing_emails": true,
    "last_logged_in_on": "2026-11-16T15:01:16.62Z",
    "created_on": "2021-08-30T13:34:44.62Z",
    "last_updated_on": "2026-10-01T18:04:43.75Z",
    "company": "Demo Company",
    "organization": null,
    "user_groups": [],
    "tax_exempt": false
  },
  "shipping_address": {
    "id": 14438,
    "name": "Default",
    "company": "",
    "first_name": "John",
    "last_name": "Doe",
    "line_1": "123 Main St.",
    "line_2": "Apt. B1",
    "line_3": null,
    "line_4": null,
    "city": "Springfield",
    "state": "MA",
    "postal_code": "01103",
    "phone": "555-123-4567",
    "email": "demo@demostore.com",
    "country_code": "US",
    "is_residential": true
  },
  "billing_address": {
    "id": 14438,
    "name": "Default",
    "company": "",
    "first_name": "John",
    "last_name": "Doe",
    "line_1": "123 Main St.",
    "line_2": "Apt. B1",
    "line_3": null,
    "line_4": null,
    "city": "Springfield",
    "state": "MA",
    "postal_code": "01103",
    "phone": "555-123-4567",
    "email": "demo@demostore.com",
    "country_code": "US",
    "is_residential": true
  },
  "payment_creditcard": false,
  "payment_check": false,
  "payment_cod": false,
  "payment_po": false,
  "payment_invoice": true,
  "payment_paypal": false,
  "payment_reference": null,
  "payment_avscode": null,
  "payment_cvcode": null,
  "card_type": null,
  "card_number": null,
  "check_number": null,
  "po_number": null,
  "invoice_number": "448",
  "tax_total": 0,
  "shipping_total": 12.5,
  "sub_total": 10,
  "promotion_total": 0,
  "promotion_code": null,
  "created_on": "2026-10-26T14:16:02.027Z",
  "shipped_on": null,
  "shipping_provider": "UPS",
  "shipping_service": "UPS Ground",
  "items": [
    {
      "id": 1468,
      "sub_total": 10,
      "created_on": "2026-10-26T14:15:34.897Z",
      "status": "Beginning",
      "quantity": 1,
      "due_on": null,
      "weight": 0,
      "base_price": 10,
      "options_price": 0,
      "markup_price": 0,
      "image_fee": 0,
      "download_fee": 0,
      "integration_id": "presswise-10001",
      "product_id": 9840,
      "item_number": "",
      "model_number": "",
      "name": "Shipping Box Dieline",
      "vendor": null,
      "options": [
        {
          "name": "Printed Sides",
          "value": "Outside Only",
          "option_integration_id": null,
          "value_integration_id": null
        },
        {
          "name": "Size",
          "value": "Custom",
          "option_integration_id": null,
          "value_integration_id": null
        }
      ],
      "notes": "",
      "parametric": [
        {
          "name": "blankWidth",
          "value": "26.7500"
        },
        {
          "name": "blankHeight",
          "value": "13.3750"
        }
      ],
      "reorder_ref": null,
      "shipment_index": 1
    }
  ],
  "shipments": [
    {
      "index": 1,
      "provider": "UPS",
      "service": "UPS Ground",
      "shipping_total": 12.5,
      "tax_total": 0,
      "tracking_numbers": "1Z999AA10123456784",
      "shipped_on": "2026-11-06T14:46:12.007Z",
      "ship_to_address": {
        "id": 14438,
        "name": "Default",
        "company": "",
        "first_name": "John",
        "last_name": "Doe",
        "line_1": "123 Main St.",
        "line_2": "Apt. B1",
        "line_3": null,
        "line_4": null,
        "city": "Springfield",
        "state": "MA",
        "postal_code": "01103",
        "phone": "555-123-4567",
        "email": "demo@demostore.com",
        "country_code": "US",
        "is_residential": true
      }
    }
  ],
  "checkout_fields": [
    {
      "name": "Cost Center",
      "value": "asd"
    }
  ]
}

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": "Order 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 an order's print files

GET
/api/v2/order/{orderId}/download
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32

Response Body

application/zip

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/order/0/download"
"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": "Order not found."
}
{
  "Message": "All items have not completed merge process."
}

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 an item's print files

GET
/api/v2/order/{orderId}/download/{itemId}
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32
itemId*integer

Line item id.

Formatint32

Response Body

application/zip

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/order/0/download/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": "Item not found."
}
{
  "Message": "Item has not completed merge process."
}

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 an item's source assets

GET
/api/v2/order/{orderId}/assets/{itemId}
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32
itemId*integer

Line item id.

Formatint32

Response Body

application/zip

application/json

application/json

application/json

application/json

curl -X GET "https://api.printnow.com/api/v2/order/0/assets/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": "Item 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."
}

Mark an order shipped

PATCH
/api/v2/order/{orderId}/shipped
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32

Request Body

application/json

Optional tracking number.

tracking_number?|

Optional. Tracking number to add to the order (duplicates are ignored).

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.printnow.com/api/v2/order/0/shipped" \  -H "Content-Type: application/json" \  -d '{    "tracking_number": "Z1234567890"  }'
Empty
{
  "Message": "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": "Order 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."
}

Mark an item shipped

PATCH
/api/v2/order/{orderId}/shipped/{itemId}
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32
itemId*integer

Line item id.

Formatint32

Request Body

application/json

Optional tracking number.

tracking_number?|

Optional. Tracking number to add to the order (duplicates are ignored).

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.printnow.com/api/v2/order/0/shipped/0" \  -H "Content-Type: application/json" \  -d '{    "tracking_number": "Z1234567890"  }'
Empty
{
  "Message": "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": "Order 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."
}

Set an order's status

PATCH
/api/v2/order/{orderId}/status
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32

Request Body

application/json

The status to set, with optional comments, tracking number and notifications.

order_status?|

Required. Name of the status to set; must match a status on the storefront (case-insensitive). List them with the storefront statuses endpoint.

comments?|

Comments for the order history entry. Multiple lines allowed.

tracking_number?|

Tracking number to add to the order. Duplicates are ignored.

user_initials?|

Initials recorded in the order history to show who made the change.

notify_customer?boolean

Send the status's email to the customer. Defaults to false.

notify_vendor?boolean

Send purchase order emails to the order's vendors. Defaults to false.

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.printnow.com/api/v2/order/0/status" \  -H "Content-Type: application/json" \  -d '{    "order_status": "In Progress",    "comments": "",    "tracking_number": "",    "user_initials": "",    "notify_customer": false,    "notify_vendor": false  }'
Empty
{
  "Message": "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": "Order 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."
}

Set an item's status

PATCH
/api/v2/order/{orderId}/status/{itemId}
AuthorizationBasic <token>

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

In: header

Path Parameters

orderId*integer

Order id.

Formatint32
itemId*integer

Line item id.

Formatint32

Request Body

application/json

The status to set, with optional comments, tracking number and notifications.

order_status?|

Required. Name of the status to set; must match a status on the storefront (case-insensitive). List them with the storefront statuses endpoint.

comments?|

Comments for the order history entry. Multiple lines allowed.

tracking_number?|

Tracking number to add to the order. Duplicates are ignored.

user_initials?|

Initials recorded in the order history to show who made the change.

notify_customer?boolean

Send the status's email to the customer. Defaults to false.

notify_vendor?boolean

Send purchase order emails to the order's vendors. Defaults to false.

[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.printnow.com/api/v2/order/0/status/0" \  -H "Content-Type: application/json" \  -d '{    "order_status": "In Progress",    "comments": "",    "tracking_number": "",    "user_initials": "",    "notify_customer": false,    "notify_vendor": false  }'
Empty
{
  "Message": "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": "Order 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