Skip to main content

Orders API

The Orders API allows you to create new orders and confirm them for fulfillment.

PrintfulStoreClient.orders

Printful API Reference

Source


Get list of orders

Printful API Reference

Returns list of order objects from your store

Method

PrintfulStoreClient.orders.getAllOrders(offset?: number, limit?: number, status?: OrderStatus)

Arguments

Optional status - Filter by order status

Optional offset - Result set offset

Optional limit - Number of items per page (max 100)

Example Usage:

//Soon to be added

Create a new order

Printful API Reference

Creates a new order and optionally submits it for fulfillment

Method

PrintfulStoreClient.orders.createOrder(newOrder: Order, confirm?: boolean, update_existing?: boolean)

Arguments

newOrder - information about new order

Optional confirm - Automatically submit the newly created order for fulfillment (skip the Draft phase)

Optional update_existing - Try to update existing order if an order with the specified external_id already exists

Example Usage:

//Soon to be added

Get order data

Printful API Reference

Returns order data by ID or External ID.

Method

PrintfulStoreClient.orders.getOrder(id: number | string)

Arguments

id - Order ID (integer) or External ID (if prefixed with @)

Example Usage:

//Soon to be added

Cancel an order

Printful API Reference

Cancels pending order or draft. Charged amount is returned to the store owner's credit card.

Method

PrintfulStoreClient.orders.cancelOrder(id: number | string)

Arguments

id - Order ID (integer) or External ID (if prefixed with @)

Example Usage:

//Soon to be added

Update order data

Printful API Reference

Updates unsubmitted order and optionally submits it for the fulfillment.

Method

PrintfulStoreClient.orders.updateOrder(id: number | string, orderData: Order, confirm?: boolean)

Arguments

id - Order ID (integer) or External ID (if prefixed with @) orderData - Update information about the order Optional confirm - Automatically submit the newly created order for fulfillment (skip the Draft phase)

Example Usage:

//Soon to be added

Confirm draft for fulfillment

Printful API Reference

Approves for fulfillment an order that was saved as a draft. Store owner's credit card is charged when the order is submitted for fulfillment.

Method

PrintfulStoreClient.orders.confirmOrder(id: number | string)

Arguments

id - Order ID (integer) or External ID (if prefixed with @)

Example Usage:

//Soon to be added

Estimate order costs

Printful API Reference

Calculates the estimated order costs including item costs, print costs (back prints, inside labels etc.), shipping and taxes

Method

PrintfulStoreClient.orders.estimateOrderCost(orderData: Order)

Arguments

orderData - Information on order for which estimate will be returned

Example Usage:

//Soon to be added