Storefronts
Find your storefronts and their order statuses and sales reps, search their orders, and list abandoned carts.
A token/key pair covers every storefront in your PrintNow account. Start with the storefront list: most other endpoints take a storefront id.
Statuses and sales reps
The status list is the set of order statuses configured on a storefront, in order. Use a status's id to filter the order search and its name to set an order's status (Orders section). The sales rep list is the storefront's customers flagged as sales reps; use their ids to filter the order search.
Order search
- 20 orders per page, oldest first.
total_resultsandtotal_pagestell you how far to page. - Filters combine and are all optional: free text (
query), a date range (fromDate/toDate,YYYY-MM-DD), statuses and sales reps (comma-separated ids), and the view:active(default),archivedordeleted. - Each result is a full order, the same as the Get Order response.
Abandoned carts
Carts that still hold items, belonging to permanent (not guest) customers. Choose the period either way:
fromDateandtoDatetogether (YYYY-MM-DD); orrecentSpan: a number and a unit,d(days),w(weeks) orm(30-day months), counted back from today, for example14d,2wor3m. The default is 7 days.recentSpanis used wheneverfromDateandtoDatearen't both given.
The period can't start more than 180 days ago (7m is 210 days, so it's refused). Each cart lists its items with their options and a thumbnail path relative to the storefront's domain.
List storefronts
Authorization
basic Your API token as the username and your API key as the password.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/all"[
{
"id": 1,
"name": "Retail Print Site",
"url": "https://www.retailprintsite.com",
"is_retail": true
},
{
"id": 2,
"name": "B2B Print Site",
"url": "https://www.b2bprintsite.com",
"is_retail": false
}
]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."
}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."
}Get a storefront
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Storefront id.
int32Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/0"{
"id": 1,
"name": "Demo Store",
"url": "demostore.com",
"is_retail": true
}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": "string"
}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."
}List a storefront's order statuses
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Storefront id.
int32Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/0/statuses"[
{
"id": 1,
"name": "Beginning",
"is_production": false,
"order": 1
},
{
"id": 105,
"name": "Needs Proof",
"is_production": false,
"order": 2
}
]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": "string"
}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."
}List a storefront's sales reps
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Storefront id.
int32Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/0/sales_reps"[
{
"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
},
{
"storefront": "Demo Store",
"storefront_id": 1,
"id": 51516,
"first_name": "Demo",
"last_name": "Approver",
"email": "approver@demostore.com",
"username": "approver",
"receive_marketing_emails": true,
"last_logged_in_on": "2012-11-26T16:41:42.317Z",
"created_on": "2012-11-26T15:57:09.927Z",
"last_updated_on": "2026-11-05T16:54:49.493Z",
"company": null,
"organization": null,
"user_groups": [],
"tax_exempt": false
}
]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": "string"
}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."
}Search a storefront's orders
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Storefront id.
int32Query Parameters
Text to match in the order id, the customer's first or last name, the PO number, or the billing or shipping first or last name.
""Only orders placed on or after this date (YYYY-MM-DD).
date-timeOnly orders placed on or before this date (YYYY-MM-DD).
date-timeComma-separated status ids (see the status list).
Comma-separated sales rep customer ids (see the sales rep list).
Page number, from 1. Defaults to 1.
1int32active (default): neither archived nor deleted; archived; or deleted.
"active"Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/0/search_orders"{
"total_results": 738,
"page": 1,
"total_pages": 37,
"orders": [
{
"storefront": "Demo Store",
"id": 15,
"is_archived": false,
"is_deleted": false,
"integration_id": null,
"status": "Declined",
"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": 1,
"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": 1,
"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": true,
"payment_check": false,
"payment_cod": false,
"payment_po": false,
"payment_invoice": false,
"payment_paypal": false,
"payment_reference": null,
"payment_avscode": null,
"payment_cvcode": null,
"card_type": "Visa",
"card_number": "2222",
"check_number": null,
"po_number": null,
"invoice_number": null,
"tax_total": 0,
"shipping_total": 1,
"sub_total": 8,
"promotion_total": 0,
"promotion_code": null,
"created_on": "2012-01-10T05:00:00Z",
"shipped_on": null,
"shipping_provider": "FIXED",
"shipping_service": "None",
"items": [
{
"id": 15,
"sub_total": 8,
"created_on": "2012-02-14T20:16:29.493Z",
"status": "Declined",
"quantity": 10,
"due_on": null,
"weight": 0.0586,
"base_price": 8,
"options_price": 0,
"markup_price": 0,
"image_fee": 0,
"download_fee": 0,
"integration_id": "",
"product_id": 2,
"item_number": "104",
"model_number": "static-product-2",
"name": "Static Product",
"vendor": null,
"options": [],
"notes": "",
"parametric": null,
"reorder_ref": null,
"shipment_index": 1
}
],
"shipments": [],
"checkout_fields": []
},
{
"storefront": "Demo Store",
"id": 39,
"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": 1,
"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": 1,
"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": true,
"payment_check": false,
"payment_cod": false,
"payment_po": false,
"payment_invoice": false,
"payment_paypal": false,
"payment_reference": "6773172",
"payment_avscode": "",
"payment_cvcode": "",
"card_type": "Visa",
"card_number": "2222",
"check_number": null,
"po_number": null,
"invoice_number": null,
"tax_total": 0,
"shipping_total": 1,
"sub_total": 8,
"promotion_total": 0,
"promotion_code": null,
"created_on": "2012-01-10T05:00:00Z",
"shipped_on": null,
"shipping_provider": "FIXED",
"shipping_service": "None",
"items": [
{
"id": 39,
"sub_total": 8,
"created_on": "2012-02-21T14:33:57.833Z",
"status": "Beginning",
"quantity": 10,
"due_on": null,
"weight": 32.2504,
"base_price": 8,
"options_price": 0,
"markup_price": 0,
"image_fee": 0,
"download_fee": 0,
"integration_id": "",
"product_id": 2,
"item_number": "104",
"model_number": "static-product-2",
"name": "Static Product",
"vendor": null,
"options": [
{
"name": "Color",
"value": "Full Color",
"option_integration_id": null,
"value_integration_id": null
},
{
"name": "Size",
"value": "3.5\" × 2\"",
"option_integration_id": null,
"value_integration_id": null
}
],
"notes": "",
"parametric": null,
"reorder_ref": null,
"shipment_index": 1
}
],
"shipments": [],
"checkout_fields": []
}
]
}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."
}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."
}List a storefront's abandoned carts
Authorization
basic Your API token as the username and your API key as the password.
In: header
Path Parameters
Storefront id.
int32Query Parameters
Start of the range (YYYY-MM-DD). Used only together with toDate, otherwise ignored.
date-timeEnd of the range (YYYY-MM-DD). Used only together with fromDate, otherwise ignored.
date-timeRange ending today, used when fromDate and toDate are not both given: a number followed by d (days), w (weeks) or m (30-day months), for example 14d, 2w or 3m. Defaults to 7 days.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.printnow.com/api/v2/storefront/0/abandoned_carts"[
{
"created_on": "2025-02-10T14:28:21.773",
"customer_id": 24,
"first_name": "Demo",
"last_name": "User",
"email": "demo.user@domain.com",
"items": [
{
"name": "Political 01 - 8\" x 6\"",
"quantity": 500,
"options": [
{
"name": "Printing",
"value": "Full Color Both Sides"
},
{
"name": "Size (W x H)",
"value": "8\" x 6\""
},
{
"name": "Turnaround",
"value": "4 Business Days"
},
{
"name": "Paper",
"value": "12 Pt C2S with Gloss UV Front"
},
{
"name": "Mailing Services",
"value": "None - Ship to Me"
},
{
"name": "Proof",
"value": "Manually Processed PDF Emailed"
}
],
"thumbnail": "/thumbnails/p/210641"
},
{
"name": "Political 01 - 8\" x 6\"",
"quantity": 500,
"options": [
{
"name": "Printing",
"value": "Full Color Both Sides"
},
{
"name": "Size (W x H)",
"value": "8\" x 6\""
},
{
"name": "Turnaround",
"value": "4 Business Days"
},
{
"name": "Paper",
"value": "12 Pt C2S with Gloss UV Front"
},
{
"name": "Mailing Services",
"value": "None - Ship to Me"
},
{
"name": "Proof",
"value": "Manually Processed PDF Emailed"
}
],
"thumbnail": "/thumbnails/p/210641"
}
]
}
]{
"Message": "From date can't be more than 180 days in the past."
}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": "Storefront 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."
}