Orders

The Orders endpoints let you retrieve full order details including line items, addresses, and payment information. You can download print-ready files as ZIP archives, mark orders or individual items as shipped with tracking numbers, and update order statuses with comments and notification controls.

Endpoints

Get Order

Retrieve full order details including customer, addresses, payment, line items with options, and checkout fields.

GET /api/v2/order/{orderId}

Example Request

curl -X GET https://api.printnow.com/api/v2/order/5001 \
  -u "YOUR_TOKEN:YOUR_KEY"

Example Response

{
  "storefront": "My Print Store",
  "id": 5001,
  "is_archived": false,
  "is_deleted": false,
  "integration_id": "EXT-12345",
  "status": "New Order",
  "customer": {
    "id": 12345,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@example.com",
    "username": "janesmith"
  },
  "shipping_address": {
    "id": 100,
    "name": "Office",
    "first_name": "Jane",
    "last_name": "Smith",
    "line_1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postal_code": "10001",
    "country_code": "US",
    "is_residential": false
  },
  "billing_address": { },
  "payment_creditcard": true,
  "payment_check": false,
  "payment_cod": false,
  "payment_po": false,
  "payment_invoice": false,
  "payment_paypal": false,
  "payment_reference": "ch_abc123",
  "payment_avscode": "Y",
  "payment_cvcode": "M",
  "card_type": "Visa",
  "card_number": "4242",
  "tax_total": 8.75,
  "shipping_total": 12.50,
  "sub_total": 125.00,
  "promotion_total": 10.00,
  "promotion_code": "SAVE10",
  "created_on": "2026-01-20T09:15:00Z",
  "shipped_on": null,
  "shipping_provider": "UPS",
  "shipping_service": "Ground",
  "items": [
    {
      "id": 8001,
      "product_id": 42,
      "name": "Business Cards",
      "status": "New Order",
      "quantity": 500,
      "sub_total": 125.00,
      "base_price": 100.00,
      "options_price": 25.00,
      "markup_price": 0.00,
      "image_fee": 0.00,
      "download_fee": 0.00,
      "weight": 1.5,
      "created_on": "2026-01-20T09:15:00Z",
      "due_on": "2026-01-25T00:00:00Z",
      "item_number": "BC-001",
      "model_number": "STD-BC",
      "integration_id": "SKU-BC-500",
      "vendor": "Print Vendor Inc",
      "notes": "Please use matte finish",
      "reorder_ref": "REF-123",
      "options": [
        { "name": "Paper Stock", "value": "14pt Matte", "option_integration_id": "OPT-1", "value_integration_id": "VAL-1" }
      ],
      "parametric": null
    }
  ],
  "checkout_fields": [
    { "name": "PO Number", "value": "PO-2026-001" }
  ]
}

Order Response Fields

Order Item Fields

Option Item Fields

Parametric Property Fields

For products designed with Print CAD, parametric dimensions and configuration are included.

Address Object

Download Order

Download all print-ready files for an order as a ZIP archive. All items in the order must have completed the file merge process before download is available.

GET /api/v2/order/{orderId}/download

Returns a application/zip file stream with filename order-{orderId}.zip.

If any items have not completed the merge process, returns 409 Conflict with a Retry-After: 60 header. Poll again after the suggested interval.

Download Item

Download print-ready files for a single order item as a ZIP archive.

GET /api/v2/order/{orderId}/download/{itemId}

Returns a application/zip file stream with filename item-{itemId}.zip.

If the item has not completed the merge process, returns 409 Conflict with a Retry-After: 30 header.

Download Item Assets

Download source design assets for an order item as a ZIP archive. For custom-design products, this returns the uploaded design files. For editor-designed products, this returns the high-resolution images used in the design.

GET /api/v2/order/{orderId}/assets/{itemId}

Returns a application/zip file stream with filename item-assets-{itemId}.zip.

Mark Order Shipped

Mark all items in an order as shipped. This sets the shipped date, updates all item statuses to the "Order Shipped" status, triggers the order_updated webhook, and sends the "Order Shipped" email notification to the customer.

PATCH /api/v2/order/{orderId}/shipped

Request Body (Optional)

{
  "tracking_number": "1Z999AA10123456784"
}

Tracking numbers are appended to any existing tracking numbers on the order (duplicates are ignored). Returns 204 No Content on success.

If the storefront does not have an "Order Shipped" status configured, returns 400 Bad Request.

Mark Item Shipped

Mark a single order item as shipped while leaving other items unchanged.

PATCH /api/v2/order/{orderId}/shipped/{itemId}

Same request body and behavior as Mark Order Shipped, but only updates the specified item's status.

Update Order Status

Update all items in an order to a specific status. This is more flexible than the shipped endpoints -- you can set any status configured in the storefront, add comments, include tracking numbers, and control who gets notified.

PATCH /api/v2/order/{orderId}/status

Request Body

Example Request

curl -X PATCH https://api.printnow.com/api/v2/order/5001/status \
  -u "YOUR_TOKEN:YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_status": "In Production",
    "comments": "Sent to press",
    "user_initials": "JS",
    "notify_customer": true,
    "notify_vendor": false
  }'

Returns 204 No Content on success. The status change is recorded in the order history with an "Updated via API" note. If the target status is a shipping status (associated with the "Order Shipped" email template), the order's shipped date is also set. Triggers the order_updated webhook.

Update Item Status

Update a single item's status within an order.

PATCH /api/v2/order/{orderId}/status/{itemId}

Same request body and behavior as Update Order Status, but only affects the specified item.

Error Responses

Related Pages

• Storefronts — retrieve order statuses and search orders across storefronts
• Webhooks — receive order_created and order_updated event notifications
• Orders — manage orders and update statuses in the admin UI