Warehouse Shipments API

Get a list of your warehouse shipments

GET https://api.printful.com/warehouse/shipments

Returns a list of warehouse shipments from your store
Input parameters:
status string Filter by shipment status
offset integer Result set offset
limit integer Number of items per page (max 100)
Response format:
code integer Response status code 200
result WarehouseShipment [ ]
id integer Shipment ID
location string Warehouse which shipment is sent to
status string Shipment status:
shipped - shipment is shipped
delivered - shipment is delivered to our warehouse
received - shipment is received (first item is stocked in our system)
processed - all items in shipment are processed
canceled - shipment is canceled
failed - there was an error when receiving or processing shipment
draft - shipment is created as a draft
tracking_number string Shipment’s tracking number
carrier string Carrier delivering the shipment
items WarehouseShipmentItem [ ] Array of items in shipment
quantity integer Quantity of item in shipment
variant WarehouseProductVariant Product variant
id integer Product variant ID
name string Name of product variant
sku string SKU of product variant
image_url string Image URL of product variant
retail_price float Retail price of product variant
quantity integer Quantity of product variant in our stock
length float Length of product variant
width float Width of product variant
height float Height of product variant
weight float Weight of product variant
paging Paging Paging information
total integer Total number of items available
offset integer Current result set page offset
limit integer Max number of items per page
API key
status Filter by shipment status
offset Result set offset
limit Number of items per page (max 100)
Execute

Create new warehouse shipment

POST https://api.printful.com/warehouse/shipments

Creates and submits new warehouse shipment
Input parameters:
Request body WarehouseShipmentCreate Warehouse shipment data
id integer Shipment ID
location_id string Location ID:
3 - Charlotte, USA
4 - Riga, Latvia
tracking_number string Shipment’s tracking number (generate your own is using HQ Drop-Off)
carrier string Carrier delivering the shipment (use HQDROPOFF to set this shipment for HQ Drop-Off)
items WarehouseShipmentItemCreate [ ] Array of items in shipment
quantity integer Quantity of item in shipment
variant_id integer Product variant ID
Response format:
code integer Response status code 200
result WarehouseShipment
id integer Shipment ID
location string Warehouse which shipment is sent to
status string Shipment status:
shipped - shipment is shipped
delivered - shipment is delivered to our warehouse
received - shipment is received (first item is stocked in our system)
processed - all items in shipment are processed
canceled - shipment is canceled
failed - there was an error when receiving or processing shipment
draft - shipment is created as a draft
tracking_number string Shipment’s tracking number
carrier string Carrier delivering the shipment
items WarehouseShipmentItem [ ] Array of items in shipment
quantity integer Quantity of item in shipment
variant WarehouseProductVariant Product variant
id integer Product variant ID
name string Name of product variant
sku string SKU of product variant
image_url string Image URL of product variant
retail_price float Retail price of product variant
quantity integer Quantity of product variant in our stock
length float Length of product variant
width float Width of product variant
height float Height of product variant
weight float Weight of product variant
API key
Request body
Execute

Get warehouse shipment data

GET https://api.printful.com/warehouse/shipments/{id}

Returns warehouse shipment data by ID
Input parameters:
id integer / string Shipment ID (integer)
Response format:
code integer Response status code 200
result WarehouseShipment
id integer Shipment ID
location string Warehouse which shipment is sent to
status string Shipment status:
shipped - shipment is shipped
delivered - shipment is delivered to our warehouse
received - shipment is received (first item is stocked in our system)
processed - all items in shipment are processed
canceled - shipment is canceled
failed - there was an error when receiving or processing shipment
draft - shipment is created as a draft
tracking_number string Shipment’s tracking number
carrier string Carrier delivering the shipment
items WarehouseShipmentItem [ ] Array of items in shipment
quantity integer Quantity of item in shipment
variant WarehouseProductVariant Product variant
id integer Product variant ID
name string Name of product variant
sku string SKU of product variant
image_url string Image URL of product variant
retail_price float Retail price of product variant
quantity integer Quantity of product variant in our stock
length float Length of product variant
width float Width of product variant
height float Height of product variant
weight float Weight of product variant
API key
id Shipment ID (integer)
Execute

Ready to try Printful ?

Get Me Started