PrintNowPrintNowDocs

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.

  • 20 orders per page, oldest first. total_results and total_pages tell 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), archived or deleted.
  • 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:

  • fromDate and toDate together (YYYY-MM-DD); or
  • recentSpan: a number and a unit, d (days), w (weeks) or m (30-day months), counted back from today, for example 14d, 2w or 3m. The default is 7 days. recentSpan is used whenever fromDate and toDate aren'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

GET
/api/v2/storefront/all
AuthorizationBasic <token>

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

GET
/api/v2/storefront/{storefrontId}
AuthorizationBasic <token>

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

In: header

Path Parameters

storefrontId*integer

Storefront id.

Formatint32

Response 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

GET
/api/v2/storefront/{storefrontId}/statuses
AuthorizationBasic <token>

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

In: header

Path Parameters

storefrontId*integer

Storefront id.

Formatint32

Response 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

GET
/api/v2/storefront/{storefrontId}/sales_reps
AuthorizationBasic <token>

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

In: header

Path Parameters

storefrontId*integer

Storefront id.

Formatint32

Response 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

GET
/api/v2/storefront/{storefrontId}/search_orders
AuthorizationBasic <token>

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

In: header

Path Parameters

storefrontId*integer

Storefront id.

Formatint32

Query Parameters

query?|

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.

Default""
fromDate?|

Only orders placed on or after this date (YYYY-MM-DD).

Formatdate-time
toDate?|

Only orders placed on or before this date (YYYY-MM-DD).

Formatdate-time
status?|

Comma-separated status ids (see the status list).

sales_rep?|

Comma-separated sales rep customer ids (see the sales rep list).

page?integer

Page number, from 1. Defaults to 1.

Default1
Formatint32
view?|

active (default): neither archived nor deleted; archived; or deleted.

Default"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

GET
/api/v2/storefront/{storefrontId}/abandoned_carts
AuthorizationBasic <token>

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

In: header

Path Parameters

storefrontId*integer

Storefront id.

Formatint32

Query Parameters

fromDate?|

Start of the range (YYYY-MM-DD). Used only together with toDate, otherwise ignored.

Formatdate-time
toDate?|

End of the range (YYYY-MM-DD). Used only together with fromDate, otherwise ignored.

Formatdate-time
recentSpan?|

Range 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."
}

On this page