Complete fulfillment

POST 
/openapi/2026-07/orders/:order_id/fulfillments/:fulfillment_id/complete

Marks a specific fulfillment as complete. If the fulfillment is already finished, the API retrieves and returns the fulfillment details instead.

Request

Path Parameters

order_id stringrequired

Order ID

fulfillment_id stringrequired

Fulfillment ID to complete

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

fulfillment object

The completed fulfillment

idstring

Fulfillment ID

order_idstring

Order's ID

statusstring

Fulfillment status:

• pending: pending shipment
• shipped: shipped
• finished: finished
• cancelled: cancelled

created_atstring

Creation time, in ISO-8601 format

updated_atstring

Last update time, in ISO-8601 format

tracking_companystring

Logistics company

tracking_numberstring

Tracking number

tracking_company_codestring

Logistics company code

line_items object[]

Line items included in this fulfillment

Array [

idstring

Line item ID

product_idstring

Product associated with this line item ID

product_titlestring

The name of the product purchased

variant_idstring

Specific variant of the product ID

variant_titlestring

The title of the product variant, for example, "Blue, Size M"

quantityuint32

The number of units of this product purchased

notestring

A note related to the product in this line item, added by the merchant or customer

image object

Image

srcstring

The source URL of the image

widthint32

The width of the image in pixels

heightint32

The height of the image in pixels

altstring

Alt text for the image

pricestring

Price

compare_at_pricestring

Compare-at price

total_pricestring

Total price

fulfillment_statusstring

The fulfillment status of this line item. For example, "fulfilled", "unfulfilled". See Fulfillment Status

skustring

Stock Keeping Unit (SKU) for the product variant, used for inventory tracking

weightstring

Weight of the product

weight_unitstring

Unit of measurement for the product weight. For example, "kg", "lbs"

vendorstring

The vendor or supplier of the product

product_urlstring

The URL of the product page for customers

created_atstring

Creation time, in ISO-8601 format

updated_atstring

Last update time, in ISO-8601 format

options object[]

Product option values (a.k.a. variant option values) associated with this line item

Array [

namestring

Option name

valuestring

Option value

]

product_slugstring

URL-friendly identifier of the product

taxableboolean

Whether the line item is taxable

requires_shippingboolean

Whether this line item requires shipping

spustring

Standard Product Unit (SPU)

product_tagsstring

Product tags

refund_quantity_totaluint32

Refunded quantity for this line item

ship_quantityuint32

Shipped quantity for this line item

customboolean

Whether the line item is a custom item

trunk_pricestring

Trunk price

discount_applicationsstring

Number of discounts applied to the shipping for this line item

tax_pricestring

Tax of the line item

duty_pricestring

Duty cost

payment_discount_pricestring

Price of payment discounts applied to the line item

custom_propertiesobject

Custom properties of the line item, such as size, color, etc. JSON format

]

tracking_urlstring

Tracking URL

phone_numberstring

Phone number

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "fulfillment": {
      "id": "string",
      "order_id": "string",
      "status": "string",
      "created_at": "string",
      "updated_at": "string",
      "tracking_company": "string",
      "tracking_number": "string",
      "tracking_company_code": "string",
      "line_items": [
        {
          "id": "string",
          "product_id": "string",
          "product_title": "string",
          "variant_id": "string",
          "variant_title": "string",
          "quantity": 0,
          "note": "string",
          "image": {
            "src": "string",
            "width": 0,
            "height": 0,
            "alt": "string"
          },
          "price": "string",
          "compare_at_price": "string",
          "total_price": "string",
          "fulfillment_status": "string",
          "sku": "string",
          "weight": "string",
          "weight_unit": "string",
          "vendor": "string",
          "product_url": "string",
          "created_at": "string",
          "updated_at": "string",
          "options": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "product_slug": "string",
          "taxable": true,
          "requires_shipping": true,
          "spu": "string",
          "product_tags": "string",
          "refund_quantity_total": 0,
          "ship_quantity": 0,
          "custom": true,
          "trunk_price": "string",
          "discount_applications": "string",
          "tax_price": "string",
          "duty_price": "string",
          "payment_discount_price": "string",
          "custom_properties": {}
        }
      ],
      "tracking_url": "string",
      "phone_number": "string"
    }
  }
}