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.
Print files
Each item's print-ready file is produced by a merge step after the order is placed. Download the files as zips:
| Download | Contains |
|---|---|
| Order files | Every item's print files (order-{orderId}.zip). |
| Item files | One item's print files (item-{itemId}.zip). |
| Item assets | One 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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Response 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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Response 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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Line item id.
int32Response 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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Line item id.
int32Response 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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Request Body
application/json
Optional tracking number.
Optional. Tracking number to add to the order (duplicates are ignored).
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" }'{
"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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Line item id.
int32Request Body
application/json
Optional tracking number.
Optional. Tracking number to add to the order (duplicates are ignored).
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" }'{
"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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Request Body
application/json
The status to set, with optional comments, tracking number and notifications.
Required. Name of the status to set; must match a status on the storefront (case-insensitive). List them with the storefront statuses endpoint.
Comments for the order history entry. Multiple lines allowed.
Tracking number to add to the order. Duplicates are ignored.
Initials recorded in the order history to show who made the change.
Send the status's email to the customer. Defaults to false.
Send purchase order emails to the order's vendors. Defaults to false.
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 }'{
"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
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Order id.
int32Line item id.
int32Request Body
application/json
The status to set, with optional comments, tracking number and notifications.
Required. Name of the status to set; must match a status on the storefront (case-insensitive). List them with the storefront statuses endpoint.
Comments for the order history entry. Multiple lines allowed.
Tracking number to add to the order. Duplicates are ignored.
Initials recorded in the order history to show who made the change.
Send the status's email to the customer. Defaults to false.
Send purchase order emails to the order's vendors. Defaults to false.
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 }'{
"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."
}Authentication
Every REST request uses HTTP Basic authentication with an API token as the username and its API key as the password. (The cXML endpoint carries the same token and key inside the cXML header instead; see the cXML section.)
Customers
Create, read, update, transfer and delete customer accounts on your storefronts.