**Version: 202601**

# Complete fulfillment

**POST** `/openapi/2026-01/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` string (required)

  Order ID
- `fulfillment_id` string (required)

  Fulfillment ID to complete

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `fulfillment` object

    The completed fulfillment

    - `id` string

      Fulfillment ID
    - `order_id` string

      Order's ID
    - `status` string

      Fulfillment status:

      *   `pending`: pending shipment
      *   `shipped`: shipped
      *   `finished`: finished
      *   `cancelled`: cancelled
    - `created_at` string

      Creation time, in ISO-8601 format
    - `updated_at` string

      Last update time, in ISO-8601 format
    - `tracking_company` string

      Logistics company
    - `tracking_number` string

      Tracking number
    - `tracking_company_code` string

      Logistics company code
    - `line_items` object[]

      Line items included in this fulfillment

      *   Array \[

      - `id` string

        Line item ID
      - `product_id` string

        Product associated with this line item ID
      - `product_title` string

        The name of the product purchased
      - `variant_id` string

        Specific variant of the product ID
      - `variant_title` string

        The title of the product variant, for example, "Blue, Size M"
      - `quantity` uint32

        The number of units of this product purchased
      - `note` string

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

        Image

        - `src` string

          The source URL of the image
        - `width` int32

          The width of the image in pixels
        - `height` int32

          The height of the image in pixels
        - `alt` string

          Alt text for the image
      - `price` string

        Price
      - `compare_at_price` string

        Compare-at price
      - `total_price` string

        Total price
      - `fulfillment_status` string

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

        Stock Keeping Unit (SKU) for the product variant, used for inventory tracking
      - `weight` string

        Weight of the product
      - `weight_unit` string

        Unit of measurement for the product weight. For example, "kg", "lbs"
      - `vendor` string

        The vendor or supplier of the product
      - `product_url` string

        The URL of the product page for customers
      - `created_at` string

        Creation time, in ISO-8601 format
      - `updated_at` string

        Last update time, in ISO-8601 format
      - `options` object[]

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

        *   Array \[

        - `name` string

          Option name
        - `value` string

          Option value
        *   \]
      - `product_slug` string

        URL-friendly identifier of the product
      - `taxable` boolean

        Whether the line item is taxable
      - `requires_shipping` boolean

        Whether this line item requires shipping
      - `spu` string

        Standard Product Unit (SPU)
      - `product_tags` string

        Product tags
      - `refund_quantity_total` uint32

        Refunded quantity for this line item
      - `ship_quantity` uint32

        Shipped quantity for this line item
      - `custom` boolean

        Whether the line item is a custom item
      - `trunk_price` string

        Trunk price
      - `discount_applications` string

        Number of discounts applied to the shipping for this line item
      - `tax_price` string

        Tax of the line item
      - `duty_price` string

        Duty cost
      - `payment_discount_price` string

        Price of payment discounts applied to the line item
      - `custom_properties` object

        Custom properties of the line item, such as size, color, etc. JSON format
      *   \]
    - `tracking_url` string

      Tracking URL
    - `phone_number` string

      Phone number

```json
{
  "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"
    }
  }
}
```
