🔒
Requires write_order access scope. More access scope

The Cancel Fulfillment API cancels a specific fulfillment for an order. This action marks the fulfillment as canceled, stopping any further processing or shipping operations.

This API is especially useful for:

Canceling shipments or fulfillments that are no longer needed.
Managing order updates during the fulfillment process.
Ensuring inventory or shipping workflows are correctly adjusted.

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Parameter	Type	Required	Example	Description
`order_id`	string	Yes	`633130-00000012`	Unique identifier for the order.
`fulfillment_id`	string	Yes	`49a731b0-1b7e-47c3-94d9-6d688f36201e`	Unique identifier for the fulfillment.

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Success Response

Field	Type	Description	Example
`code`	string	`"success"`	Response status code
`message`	string		Descriptive message of the response
`data.fulfillment`	object	fulfillment	fulfillment details

Fulfillment Object Structure

Parameter	Type	Example	Description
`id`	string	`ful_123456`	Unique identifier for the fulfillment
`order_id`	string	`ord_123456`	ID of the associated order
`status`	string	`success`	Status of the fulfillment creation
`created_at`	string	`2023-06-01T00:00:00Z`	Creation time (ISO 8601 format)
`updated_at`	string	`2023-06-01T00:00:00Z`	Last modified time (ISO 8601 format)
`tracking_company`	string	`UPS`	Shipping carrier name
`tracking_number`	string	`UPS123456789`	Tracking number
`tracking_company_code`	string	`ups`	Shipping carrier code
`line_items`	array of objects	`[ {...}, {...} ]`	List of fulfilled line items

Fulfilled Line Item Object Structure

Parameter	Type	Example	Description
`id`	string	`li_123456`	Line item ID
`product_id`	string	`prod_123456`	Product ID
`product_title`	string	`Premium T-Shirt`	Product name
`variant_id`	string	`var_123456`	Variant ID
`variant_title`	string	`Blue, Size M`	Variant title
`quantity`	uint32	`2`	Quantity fulfilled
`note`	string	`Fragile item`	Merchant or customer note
`image`	object	`{...}`	Product image details
`price`	string	`19.99`	Product price
`compare_at_price`	string	`29.99`	Original price (if on sale)
`total_price`	string	`39.98`	Total price for quantity
`fulfillment_status`	string	`fulfilled`	Fulfillment status
`sku`	string	`TSKU123`	Stock Keeping Unit
`weight`	string	`0.5`	Product weight
`weight_unit`	string	`kg`	Weight unit
`vendor`	string	`Clothing Co.`	Product vendor
`product_url`	string	`https://example.com/products/premium-tshirt`	Product page URL
`created_at`	string	`2023-05-01T00:00:00Z`	Line item creation time
`updated_at`	string	`2023-06-01T00:00:00Z`	Line item last update time
`options`	array of objects	`[ {...} ]`	Product variant options
`taxable`	boolean	`true`	Whether item is taxable
`requires_shipping`	boolean	`true`	Whether item requires shipping
`spu`	string	`SPU123`	Standard Product Unit
`product_tags`	string	`new, bestseller`	Product tags
`refund_quantity_total`	uint32	`0`	Total refunded quantity
`ship_quantity`	uint32	`2`	Quantity shipped
`custom`	boolean	`false`	Whether item is custom
`trunk_price`	string	`0.0`	Trunk price (if applicable)
`discount_applications`	string	`[]`	Discount applications
`tax_price`	string	`3.20`	Tax amount
`duty_price`	string	`0.0`	Duty cost
`tracking_url`	string	`https://www.ups.com/track?tracknum=123456789`	Tracking URL
`phone_number`	string	`+1-800-123-4567`	Contact phone number

Image Object Structure

Parameter	Type	Example	Description
`src`	string	`https://example.com/product-image.jpg`	Image URL
`width`	int32	`800`	Image width in pixels
`height`	int32	`800`	Image height in pixels
`alt`	string	`Product image`	Image alt text

Error Response

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message

API Structure Overview

200OK