# Fulfillment

        <p>You can use the <code>Fulfillment</code> resource to view fulfillments for an order or a <a href="/api/admin-rest/latest/resources/fulfillmentorder">fulfillment order</a>.
        A fulfillment order represents a group of one or more items in an order that will be fulfilled from the same location. A fulfillment represents work that is completed as part of a fulfillment order and can include one or more items.
        You can use the <code>Fulfillment</code> resource to manage fulfillments for fulfillment orders.</p>
        {{ '/api/reference/fulfillment_relationships.png' | image }}
        <p>This resource is typically used in apps that perform shipping-related actions, such as making tracking and delivery updates, or creating additional shipments as required for an order or fulfillment order.</p>
        <p>Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.</p>
        <p>
          <a href="https://shopify.dev/apps/fulfillment">Learn about using fulfillment order-based workflows</a>.
        </p>

## Resource Properties

### Fulfillment

* created_at: The date and time when the fulfillment was created. The API returns this value in <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>.
  * Type: x-string
  * Example: "2012-03-13T16:09:54-04:00"
* id: The ID for the fulfillment.
  * Type: x-string
  * Example: 255858046
* line_items: <p>A list of the fulfillment's line items, which includes:</p>
<ul>
  <li><strong>id</strong>: The ID of the line item within the fulfillment.</li>
  <li><strong>variant_id</strong>: The ID of the product variant being fulfilled.</li>
  <li><strong>title</strong>: The title of the product.</li>
  <li><strong>quantity</strong>: The number of items in the fulfillment.</li>
  <li><strong>price</strong>: The price of the item before discounts have been applied in the shop currency.</li>
  <li><strong>price_set</strong>: The price of the line item in shop and presentment currencies.</li>
  <li><strong>grams</strong>: The weight of the item in grams.</li>
  <li><strong>sku</strong>: The unique identifier of the item in the fulfillment.</li>
  <li><strong>variant_title</strong>: The title of the product variant being fulfilled.</li>
  <li><strong>vendor</strong>: The name of the supplier of the item.</li>
  <li><strong>fulfillment_service</strong>: The service provider who is doing the fulfillment. This field will be deprecated. Use the <code>assigned_location</code> property on the <code>FulfillmentOrder</code> resource instead.</li>
  <li><strong>product_id</strong>: The unique numeric identifier for the product in the fulfillment.</li>
  <li><strong>requires_shipping</strong>: Whether a customer needs to provide a shipping address when placing an order for this product variant.</li>
  <li><strong>taxable</strong>: Whether the line item is taxable.</li>
  <li><strong>gift_card</strong>: Whether the line item is a <a href="https://help.shopify.com/manual/products/gift-card-products">gift card</a>.</li>
  <li><strong>name</strong>: The name of the product variant.</li>
  <li><strong>variant_inventory_management</strong>: The name of the inventory management system.</li>
  <li><strong>properties</strong>: Any additional properties associated with the line item.</li>
  <li><strong>product_exists</strong>: Whether the product exists.</li>
  <li><strong>fulfillable_quantity</strong>: The amount available to fulfill. This is the quantity - max (refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity.
  This field will be deprecated. Use the <code>fulfillable_quantity</code> property of the <code>line_item</code> property on the <code>FulfillmentOrder</code> resource instead.</li>
  <li><strong>total_discount</strong>: The total of any discounts applied to the line item with respect to its total quantity on the order. Instead of using this field, Shopify recommends using <code>discount_allocations</code>, which provides the same information.</li>
  <li><strong>fulfillment_status</strong>: The status of an order in terms of the line items being fulfilled. Valid values: <code>fulfilled</code>, <code>null</code>, or <code>partial</code>.
  This field will be deprecated. Use the <code>status</code> property on the <code>FulfillmentOrder</code> resource instead.</li>
  <li><strong>total_discount_set</strong>: The total amount allocated to the line item in the presentment currency. Instead of using this field, Shopify recommends using <code>discount_allocations</code>, which provides the same information.</li>
  <li>
    <strong>discount_allocations</strong>: An ordered list of amounts allocated by discount applications.  The amount is representative of the discount applied to the total quantity of the line item on the order, not just this fulfillment. Each discount allocation is associated with a particular discount application.
    <ul>
      <li><code>amount</code>: The discount amount allocated to the line in the shop currency.</li>
      <li><code>discount_application_index</code>: The index of the associated discount application in the order's <code>discount_applications</code> list.</li>
      <li><code>amount_set</code>: The discount amount allocated to the line item in shop and presentment currencies.</li>
    </ul>
  </li>
  <li><strong>fulfillment_line_item_id</strong>: A unique identifier for a quantity of items within a single fulfillment. An order can have multiple fulfillment line items.</li>
  <li><strong>tax_lines</strong>: The <code>title</code>, <code>price</code>, and <code>rate</code> of any taxes applied to the line item for its total quantity on the order.</li>
  <li><strong>duties</strong>: A list of duty objects, each containing information about a duty on the line item for its total quantity on the order.</li>
  
</ul>

  * Type: x-string
  * Example: [{"id"=>466157049, "variant_id"=>39072856, "title"=>"IPod Nano - 8gb", "quantity"=>1, "price"=>"199.00", "grams"=>200, "sku"=>"IPOD2008GREEN", "variant_title"=>"green", "vendor"=>nil, "fulfillment_service"=>"manual", "product_id"=>632910392, "requires_shipping"=>true, "taxable"=>true, "gift_card"=>false, "name"=>"IPod Nano - 8gb - green", "variant_inventory_management"=>"shopify", "properties"=>[], "product_exists"=>true, "fulfillable_quantity"=>1, "total_discount"=>"0.00", "fulfillment_status"=>nil, "fulfillment_line_item_id"=>274098237, "tax_lines"=>[], "duties"=>[{"id"=>"2", "harmonized_system_code"=>"520300", "country_code_of_origin"=>"CA", "shop_money"=>{"amount"=>"164.86", "currency_code"=>"CAD"}, "presentment_money"=>{"amount"=>"105.31", "currency_code"=>"EUR"}, "tax_lines"=>[{"title"=>"VAT", "price"=>"16.486", "rate"=>0.1, "price_set"=>{"shop_money"=>{"amount"=>"16.486", "currency_code"=>"CAD"}, "presentment_money"=>{"amount"=>"10.531", "currency_code"=>"EUR"}}}], "admin_graphql_api_id"=>"gid://shopify/Duty/2"}]}]
* location_id: The unique identifier of the location that the fulfillment was processed at.  To find the ID of the location, use the <a href='/docs/admin-api/rest/reference/inventory/location'>Location resource</a>.
  * Type: x-string
  * Example: 40642626
* name:           The uniquely identifying fulfillment name, consisting of two parts separated by a <code>.</code>. The first part represents the order name and the second part represents the fulfillment number. The fulfillment number automatically increments depending on how many fulfillments are in an order (e.g. <code>#1001.1</code>, <code>#1001.2</code>).

  * Type: x-string
  * Example: "#1001.1"
* order_id: The unique numeric identifier for the order.
  * Type: x-string
  * Example: 450789469
* origin_address: <p>The address of the fulfillment location. This property is intended for tax purposes,
as a full address is required for tax providers to accurately calculate taxes. To retrieve
a fulfillment location's address, use the <code>assigned_location</code>` property on the
<a href="/docs/api/admin-rest/latest/resources/fulfillmentorder">FulfillmentOrder</a> resource instead.</p>
<ul>
  <li><strong>address1</strong>: (string) The street address of the fulfillment location.</li>
  <li><strong>address2</strong>: (string) The second line of the address. Typically the number of the apartment, suite, or unit.</li>
  <li><strong>city</strong>: (string) The city of the fulfillment location.</li>
  <li>
    <strong>country_code</strong>: (string) (required) The two-letter country code
    (<a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2">ISO 3166-1 alpha-2</a> format) of the fulfillment location.
  </li>
  <li><strong>province_code</strong>: (string) The province of the fulfillment location.</li>
  <li><strong>zip</strong>: (string) The zip code of the fulfillment location.</li>
</ul>

  * Type: x-string
  * Example: [{"address1"=>"1 Rue des Carrieres", "address2"=>"Suite 1234", "city"=>"Montreal", "country_code"=>"CA", "province_code"=>"QC", "zip"=>"G1R 4P5"}]
* receipt:         <p>A text field that provides information about the receipt:</p>
        <ul>
          <li><strong>testcase</strong>: Whether the fulfillment was a testcase.</li>
          <li><strong>authorization</strong>: The authorization code. </li>
        </ul>

  * Type: x-string
  * Example: {"testcase"=>true, "authorization"=>"123456"}
* service:         <p>The fulfillment service associated with the fulfillment.</p>

  * Type: x-string
  * Example: "manual"
* shipment_status:           <p>The current shipment status of the fulfillment. Valid values:</p>
          <ul>
            <li><strong>label_printed</strong>: A label for the shipment was purchased and printed.</li>
            <li><strong>label_purchased</strong>: A label for the shipment was purchased, but not printed.</li>
            <li><strong>attempted_delivery</strong>: Delivery of the shipment was attempted, but unable to be completed.</li>
            <li><strong>ready_for_pickup</strong>: The shipment is ready for pickup at a shipping depot.</li>
            <li><strong>confirmed</strong>: The carrier is aware of the shipment, but hasn't received it yet.</li>
            <li><strong>in_transit</strong>: The shipment is being transported between shipping facilities on the way to its destination.</li>
            <li><strong>out_for_delivery</strong>: The shipment is being delivered to its final destination.</li>
            <li><strong>delivered</strong>: The shipment was succesfully delivered.</li>
            <li><strong>failure</strong>: Something went wrong when pulling tracking information for the shipment, such as the tracking number was invalid or the shipment was canceled.</li>
          </ul>

  * Type: x-string
  * Example: "confirmed"
* status:           <p>The status of the fulfillment. Valid values:</p>
          <ul>
          <li><strong>pending</strong>: Shopify has created the fulfillment and is waiting for the third-party fulfillment service to transition it to 'open' or 'success'.</li>
            <li><strong>open</strong>: The fulfillment has been acknowledged by the service and is in processing.</li>
            <li><strong>success</strong>: The fulfillment was successful.</li>
            <li><strong>cancelled</strong>: The fulfillment was cancelled.</li>
            <li><strong>error</strong>: There was an error with the fulfillment request.</li>
            <li><strong>failure</strong>: The fulfillment request failed.</li>
          </ul>

  * Type: x-string
  * Example: "failure"
* tracking_company:         <p>
          The name of the tracking company.
        </p>
        <p>
  For the tracking company names from the
  <a href="#supported-tracking-companies">list below</a>
  Shopify automatically builds tracking URLs for all of the provided tracking numbers,
  which makes the tracking numbers clickable in the interface.
</p>
<p>
  Additionally, for the tracking companies listed on the
  <a href="https://help.shopify.com/en/manual/shipping/understanding-shipping/shipping-carriers#integrated-shipping-carriers">Shipping Carriers help page</a>
  Shopify will automatically update the fulfillment's <code>shipment_status</code> field during the fulfillment process.
</p>
<aside class="note">
  <h4>Note</h4>
  <p>
    Send the tracking company name exactly as written in the list below (capitalization matters).
  </p>
</aside>

<h4 id=supported-tracking-companies>Supported tracking companies</h4>
<p>
  The following tracking companies display for shops located in any country:
</p>
<ul>
  <li><strong>4PX</strong></li>
  <li><strong>AGS</strong></li>
  <li><strong>Amazon Logistics UK</strong></li>
  <li><strong>Amazon Logistics US</strong></li>
  <li><strong>An Post</strong></li>
  <li><strong>Anjun Logistics</strong></li>
  <li><strong>APC</strong></li>
  <li><strong>Asendia USA</strong></li>
  <li><strong>Australia Post</strong></li>
  <li><strong>Bonshaw</strong></li>
  <li><strong>BPost</strong></li>
  <li><strong>BPost International</strong></li>
  <li><strong>Canada Post</strong></li>
  <li><strong>Canpar</strong></li>
  <li><strong>CDL Last Mile</strong></li>
  <li><strong>China Post</strong></li>
  <li><strong>Chronopost</strong></li>
  <li><strong>Chukou1</strong></li>
  <li><strong>Colissimo</strong></li>
  <li><strong>Comingle</strong></li>
  <li><strong>Coordinadora</strong></li>
  <li><strong>Correios</strong></li>
  <li><strong>Correos</strong></li>
  <li><strong>CTT</strong></li>
  <li><strong>CTT Express</strong></li>
  <li><strong>Cyprus Post</strong></li>
  <li><strong>Delnext</strong></li>
  <li><strong>Deutsche Post</strong></li>
  <li><strong>DHL eCommerce</strong></li>
  <li><strong>DHL eCommerce Asia</strong></li>
  <li><strong>DHL Express</strong></li>
  <li><strong>DPD</strong></li>
  <li><strong>DPD Local</strong></li>
  <li><strong>DPD UK</strong></li>
  <li><strong>DTD Express</strong></li>
  <li><strong>DX</strong></li>
  <li><strong>Eagle</strong></li>
  <li><strong>Estes</strong></li>
  <li><strong>Evri</strong></li>
  <li><strong>FedEx</strong></li>
  <li><strong>First Global Logistics</strong></li>
  <li><strong>First Line</strong></li>
  <li><strong>FSC</strong></li>
  <li><strong>Fulfilla</strong></li>
  <li><strong>GLS</strong></li>
  <li><strong>Guangdong Weisuyi Information Technology (WSE)</strong></li>
  <li><strong>Heppner Internationale Spedition GmbH &amp; Co.</strong></li>
  <li><strong>Iceland Post</strong></li>
  <li><strong>IDEX</strong></li>
  <li><strong>Israel Post</strong></li>
  <li><strong>Japan Post (EN)</strong></li>
  <li><strong>Japan Post (JA)</strong></li>
  <li><strong>La Poste</strong></li>
  <li><strong>Lasership</strong></li>
  <li><strong>Latvia Post</strong></li>
  <li><strong>Lietuvos Paštas</strong></li>
  <li><strong>Logisters</strong></li>
  <li><strong>Lone Star Overnight</strong></li>
  <li><strong>M3 Logistics</strong></li>
  <li><strong>Meteor Space</strong></li>
  <li><strong>Mondial Relay</strong></li>
  <li><strong>New Zealand Post</strong></li>
  <li><strong>NinjaVan</strong></li>
  <li><strong>North Russia Supply Chain (Shenzhen) Co.</strong></li>
  <li><strong>OnTrac</strong></li>
  <li><strong>Packeta</strong></li>
  <li><strong>Pago Logistics</strong></li>
  <li><strong>Ping An Da Tengfei Express</strong></li>
  <li><strong>Pitney Bowes</strong></li>
  <li><strong>Portal PostNord</strong></li>
  <li><strong>Poste Italiane</strong></li>
  <li><strong>PostNL</strong></li>
  <li><strong>PostNord DK</strong></li>
  <li><strong>PostNord NO</strong></li>
  <li><strong>PostNord SE</strong></li>
  <li><strong>Purolator</strong></li>
  <li><strong>Qxpress</strong></li>
  <li><strong>Qyun Express</strong></li>
  <li><strong>Royal Mail</strong></li>
  <li><strong>Royal Shipments</strong></li>
  <li><strong>Sagawa (EN)</strong></li>
  <li><strong>Sagawa (JA)</strong></li>
  <li><strong>Sendle</strong></li>
  <li><strong>SF Express</strong></li>
  <li><strong>SFC Fulfillment</strong></li>
  <li><strong>SHREE NANDAN COURIER</strong></li>
  <li><strong>Singapore Post</strong></li>
  <li><strong>Southwest Air Cargo</strong></li>
  <li><strong>StarTrack</strong></li>
  <li><strong>Step Forward Freight</strong></li>
  <li><strong>Swiss Post</strong></li>
  <li><strong>TForce Final Mile</strong></li>
  <li><strong>Tinghao</strong></li>
  <li><strong>TNT</strong></li>
  <li><strong>Toll IPEC</strong></li>
  <li><strong>United Delivery Service</strong></li>
  <li><strong>UPS</strong></li>
  <li><strong>USPS</strong></li>
  <li><strong>Venipak</strong></li>
  <li><strong>We Post</strong></li>
  <li><strong>Whistl</strong></li>
  <li><strong>Wizmo</strong></li>
  <li><strong>WMYC</strong></li>
  <li><strong>Xpedigo</strong></li>
  <li><strong>XPO Logistics</strong></li>
  <li><strong>Yamato (EN)</strong></li>
  <li><strong>Yamato (JA)</strong></li>
  <li><strong>YiFan Express</strong></li>
  <li><strong>YunExpress</strong></li>
</ul>

<p>
  The following tracking companies are displayed for shops located in specific countries:
</p>
<ul>
  <li><strong>Australia</strong>: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics</li>
  <li><strong>Austria</strong>: Österreichische Post</li>
  <li><strong>Bulgaria</strong>: Speedy</li>
  <li><strong>Canada</strong>: Intelcom, BoxKnight, Loomis, GLS</li>
  <li><strong>China</strong>: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC</li>
  <li><strong>Czechia</strong>: Zásilkovna</li>
  <li><strong>Germany</strong>: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS</li>
  <li><strong>Spain</strong>: SEUR</li>
  <li><strong>France</strong>: Colissimo, Mondial Relay, Colis Privé, GLS</li>
  <li><strong>United Kingdom</strong>: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells</li>
  <li><strong>Greece</strong>: ACS Courier</li>
  <li><strong>Hong Kong SAR</strong>: SF Express</li>
  <li><strong>Ireland</strong>: Fastway, DPD Ireland</li>
  <li><strong>India</strong>: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart</li>
  <li><strong>Italy</strong>: BRT, GLS Italy</li>
  <li><strong>Japan</strong>: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物</li>
  <li><strong>Netherlands</strong>: DHL Parcel, DPD</li>
  <li><strong>Norway</strong>: Bring</li>
  <li><strong>Poland</strong>: Inpost</li>
  <li><strong>Turkey</strong>: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo</li>
  <li><strong>United States</strong>: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo</li>
  <li><strong>South Africa</strong>: Fastway, Skynet</li>
</ul>



  * Type: x-string
  * Example: "China Post"
* tracking_numbers:           <p>
            A list of tracking numbers provided by the shipping company.
          </p>

          <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


          <p>
            The tracking numbers are clickable in the interface if one of the following applies
            (the highest in the list has the highest priority):
          </p>
          <ul>
            <li>
              Tracking URL provided in the <code>url</code> field.
            </li>
            <li>
              <a href="#supported-tracking-companies">Shopify-known tracking company name</a>
              specified in the <code>company</code> field.
              Shopify will build the tracking url automatically based on the tracking number specified.
            </li>
            <li>
              The tracking number has a Shopify-known format.
              Shopify will guess the tracking provider and build the tracking url based on the tracking number format.
              Not all tracking carriers are supported, and multiple tracking carriers may use similarly formatted tracking numbers.
              This can result in an invalid tracking URL.
              It is highly recommended that you send the tracking company and the tracking URL.
            </li>
          </ul>

  * Type: x-string
  * Example: ["112345Z2345", "1Z001985YW99744790"]
* tracking_number:           <p>
            A tracking number provided by the shipping company.
          </p>
          <p>
            If multiple tracking numbers are set on this fulfillment,
            only the first one will be returned in the <code>tracking_number</code> field.
            Use the <code>tracking_numbers</code> array field to access all tracking numbers associated with this fulfillment.
          </p>

          <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


  * Type: x-string
  * Example: "112345Z2345"
* tracking_urls:           <p>
            The URLs of tracking pages for the fulfillment.
          </p>
          <p>
            The tracking URLs are displayed in the merchant's admin on the order page.
            The tracking URLs are displayed in the shipping confirmation email, which can optionally be sent to the customer.
            When accounts are enabled, the tracking URLs are also displayed in the customer's order history.
          <p>

          <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


  * Type: x-string
  * Example: ["http://track-chinapost.com/startairmail.php?code=112345Z2345", "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z001985YW99744790&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"]
* tracking_url:           <p>
            The URL to track the fulfillment.
          </p>
          <p>
            If multiple tracking urls are set on this fulfillment,
            only the first one will be returned in the <code>tracking_url</code> field.
            Use the <code>tracking_urls</code> array field for accessing all tracking URLs associated with this fulfillment.
          </p>

          <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


  * Type: x-string
  * Example: "http://track-chinapost.com/startairmail.php?code=112345Z2345"
* updated_at:           The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>) when the fulfillment was last modified..

  * Type: x-string
  * Example: "2012-05-01T14:22:25-04:00"
* variant_inventory_management: The name of the inventory management service.
  * Type: x-string
  * Example: "shopify"
## Retrieves fulfillments associated with an order

Retrieves fulfillments associated with an order. <strong>Note:</strong> This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to <a href='/api/usage/pagination-rest'>Make paginated requests to the REST Admin API</a>.

### Endpoint
/admin/api/#{api_version}/orders/{order_id}/fulfillments.json (GET)

### Parameters
* api_version (required): 
* order_id (required): 
* created_at_max: Show fulfillments created before date (format: 2014-04-25T16:15:47-04:00).
* created_at_min: Show fulfillments created after date (format: 2014-04-25T16:15:47-04:00).
* fields: A comma-separated list of fields to include in the response.
* limit: Limit the amount of results.
* since_id: Restrict results to after the specified ID.
* updated_at_max: Show fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00).
* updated_at_min: Show fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00).

### Responses
#### 200
Retrieves fulfillments associated with an order

Examples:
##### Retrieve a list of all fulfillments for an order
Request:
```
GET /admin/api/unstable/orders/450789469/fulfillments.json
```

Response:
```
HTTP/1.1 200 OK
{"fulfillments":[{"id":255858046,"order_id":450789469,"status":"failure","created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:15-05:00","tracking_company":"USPS","shipment_status":null,"location_id":655441491,"origin_address":null,"line_items":[{"id":466157049,"variant_id":39072856,"title":"IPod Nano - 8gb","quantity":1,"sku":"IPOD2008GREEN","variant_title":"green","vendor":null,"fulfillment_service":"manual","product_id":632910392,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"IPod Nano - 8gb - green","variant_inventory_management":"shopify","properties":[{"name":"Custom Engraving Front","value":"Happy Birthday"},{"name":"Custom Engraving Back","value":"Merry Christmas"}],"product_exists":true,"fulfillable_quantity":0,"grams":200,"price":"199.00","total_discount":"0.00","fulfillment_status":null,"price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[{"amount":"3.34","discount_application_index":0,"amount_set":{"shop_money":{"amount":"3.34","currency_code":"USD"},"presentment_money":{"amount":"3.34","currency_code":"USD"}}}],"admin_graphql_api_id":"gid://shopify/LineItem/466157049","duties":[],"tax_lines":[{"price":"3.98","rate":0.06,"title":"State Tax","price_set":{"shop_money":{"amount":"3.98","currency_code":"USD"},"presentment_money":{"amount":"3.98","currency_code":"USD"}},"channel_liable":null}],"fulfillment_line_item_id":225088298}],"tracking_number":"1Z1234512345123456","tracking_numbers":["1Z1234512345123456"],"tracking_url":"https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456","tracking_urls":["https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456"],"receipt":{"testcase":true,"authorization":"123456"},"name":"#1001.0","admin_graphql_api_id":"gid://shopify/Fulfillment/255858046"}]}
```
##### Retrieve all fulfillments after the specified ID
Request:
```
GET /admin/api/unstable/orders/450789469/fulfillments.json
```

Response:
```
HTTP/1.1 200 OK
{"fulfillments":[{"id":1069019878,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:43-05:00","service":"shipwire-app","updated_at":"2025-01-02T11:38:43-05:00","tracking_company":"my-custom-shipping-company","shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":518995019,"variant_id":49148385,"title":"IPod Nano - 8gb","quantity":1,"sku":"IPOD2008RED","variant_title":"red","vendor":null,"fulfillment_service":"shipwire-app","product_id":632910392,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"IPod Nano - 8gb - red","variant_inventory_management":"shopify","properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":200,"price":"199.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[{"amount":"3.33","discount_application_index":0,"amount_set":{"shop_money":{"amount":"3.33","currency_code":"USD"},"presentment_money":{"amount":"3.33","currency_code":"USD"}}}],"admin_graphql_api_id":"gid://shopify/LineItem/518995019","duties":[],"tax_lines":[{"price":"3.98","rate":0.06,"title":"State Tax","price_set":{"shop_money":{"amount":"3.98","currency_code":"USD"},"presentment_money":{"amount":"3.98","currency_code":"USD"}},"channel_liable":null}],"fulfillment_line_item_id":1024374829}],"tracking_number":"123456789","tracking_numbers":["123456789"],"tracking_url":"http://my-custom-shipping-company.shopifyapps.com/track/123456","tracking_urls":["http://my-custom-shipping-company.shopifyapps.com/track/123456","http://my-custom-shipping-company.shopifyapps.com/track/789012"],"receipt":{},"name":"#1001.1","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019878"}]}
```
## Retrieves fulfillments associated with a fulfillment order

Retrieves fulfillments associated with a fulfillment order.

### Endpoint
/admin/api/#{api_version}/fulfillment_orders/{fulfillment_order_id}/fulfillments.json (GET)

### Parameters
* api_version (required): 
* fulfillment_order_id (required): 
* fulfillment_order_id: The ID of the fulfillment order that is associated with the fulfillments.

### Responses
#### 200
Retrieves fulfillments associated with a fulfillment order

Examples:
##### Retrieve a list of all fulfillments for a fulfillment order
Request:
```
GET /admin/api/unstable/fulfillment_orders/1046000819/fulfillments.json
```

Response:
```
HTTP/1.1 200 OK
{"fulfillments":[{"id":1069019880,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:15-05:00","tracking_company":"UPS","shipment_status":null,"location_id":24826418,"origin_address":{"address1":"150 Elgin St","city":"Ottawa","zip":"K2P 1L4","province_code":"ON","country_code":"CA"},"line_items":[{"id":1071823219,"variant_id":43729076,"title":"Draft","quantity":1,"sku":"draft-151","variant_title":"151cm","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":108828309,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Draft - 151cm","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":1,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823219","tax_lines":[]}],"tracking_number":"#☠1☢\n---\n4321\n","tracking_numbers":["#☠1☢\n---\n4321\n"],"tracking_url":"https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=#☠1☢---4321","tracking_urls":["https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=#☠1☢---4321"],"receipt":{},"name":"#1001.1","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019880"}]}
```
## Retrieves a count of fulfillments associated with a specific order

Retrieves a count of fulfillments associated with a specific order

### Endpoint
/admin/api/#{api_version}/orders/{order_id}/fulfillments/count.json (GET)

### Parameters
* api_version (required): 
* order_id (required): 
* created_at_max: Count fulfillments created before date (format: 2014-04-25T16:15:47-04:00).
* created_at_min: Count fulfillments created after date (format: 2014-04-25T16:15:47-04:00).
* updated_at_max: Count fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00).
* updated_at_min: Count fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00).

### Responses
#### 200
Retrieves a count of fulfillments associated with a specific order

Examples:
##### Count the total number of fulfillments for an order
Request:
```
GET /admin/api/unstable/orders/450789469/fulfillments/count.json
```

Response:
```
HTTP/1.1 200 OK
{"count":1}
```
## Receive a single Fulfillment

Retrieve a specific fulfillment

### Endpoint
/admin/api/#{api_version}/orders/{order_id}/fulfillments/{fulfillment_id}.json (GET)

### Parameters
* api_version (required): 
* fulfillment_id (required): 
* order_id (required): 
* fields: Comma-separated list of fields to include in the response.

### Responses
#### 200
Receive a single Fulfillment

Examples:
##### Retrieve a specific fulfillment
Request:
```
GET /admin/api/unstable/orders/450789469/fulfillments/255858046.json
```

Response:
```
HTTP/1.1 200 OK
{"fulfillment":{"id":255858046,"order_id":450789469,"status":"failure","created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:15-05:00","tracking_company":"USPS","shipment_status":null,"location_id":655441491,"origin_address":null,"line_items":[{"id":466157049,"variant_id":39072856,"title":"IPod Nano - 8gb","quantity":1,"sku":"IPOD2008GREEN","variant_title":"green","vendor":null,"fulfillment_service":"manual","product_id":632910392,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"IPod Nano - 8gb - green","variant_inventory_management":"shopify","properties":[{"name":"Custom Engraving Front","value":"Happy Birthday"},{"name":"Custom Engraving Back","value":"Merry Christmas"}],"product_exists":true,"fulfillable_quantity":1,"grams":200,"price":"199.00","total_discount":"0.00","fulfillment_status":null,"price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[{"amount":"3.34","discount_application_index":0,"amount_set":{"shop_money":{"amount":"3.34","currency_code":"USD"},"presentment_money":{"amount":"3.34","currency_code":"USD"}}}],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/466157049","tax_lines":[{"title":"State Tax","price":"3.98","rate":0.06,"channel_liable":null,"price_set":{"shop_money":{"amount":"3.98","currency_code":"USD"},"presentment_money":{"amount":"3.98","currency_code":"USD"}}}]}],"tracking_number":"1Z1234512345123456","tracking_numbers":["1Z1234512345123456"],"tracking_url":"https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456","tracking_urls":["https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456"],"receipt":{"testcase":true,"authorization":"123456"},"name":"#1001.0","admin_graphql_api_id":"gid://shopify/Fulfillment/255858046"}}
```
## Creates a fulfillment for one or many fulfillment orders

Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location.

### Endpoint
/admin/api/#{api_version}/fulfillments.json (POST)

### Parameters
* api_version (required): 
* line_items_by_fulfillment_order (required): <p>
  The fulfillment order line items that have to be fulfilled.
</p>
<ul>
  <li><strong>fulfillment_order_id</strong>: (integer) (required) The ID of the fulfillment order.</li>
  <li>
    <strong>fulfillment_order_line_items</strong>: (array) The fulfillment order line items and the quantity of each which should be fulfilled.
    If this property is <code>undefined</code>, then all of the fulfillment order line items of the associated fulfillment order are fulfilled.
    <ul>
      <li><strong>id</strong>: (integer) (required) The ID of the fulfillment order line item.</li>
      <li><strong>quantity</strong>: (integer) (required) (minimum: 1) The quantity of the fulfillment order line item.</li>
    </ul>
  </li>
</ul>

* message: A message that's associated with the fulfillment request. This message is only available if the associated
fulfillment order is assigned to a third-party fulfillment service that has opted in to managing fulfillment
orders.

* notify_customer: Whether the customer should be notified.
If set to <code>true</code>, then an email will be sent when the fulfillment is created or updated.
The default value is <code>false</code>.

* origin_address: <p>The address of the fulfillment location. This property is intended for tax purposes,
as a full address is required for tax providers to accurately calculate taxes. To retrieve
a fulfillment location's address, use the <code>assigned_location</code>` property on the
<a href="/docs/api/admin-rest/latest/resources/fulfillmentorder">FulfillmentOrder</a> resource instead.</p>
<ul>
  <li><strong>address1</strong>: (string) The street address of the fulfillment location.</li>
  <li><strong>address2</strong>: (string) The second line of the address. Typically the number of the apartment, suite, or unit.</li>
  <li><strong>city</strong>: (string) The city of the fulfillment location.</li>
  <li>
    <strong>country_code</strong>: (string) (required) The two-letter country code
    (<a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2">ISO 3166-1 alpha-2</a> format) of the fulfillment location.
  </li>
  <li><strong>province_code</strong>: (string) The province of the fulfillment location.</li>
  <li><strong>zip</strong>: (string) The zip code of the fulfillment location.</li>
</ul>

* tracking_info: <p>The tracking information for the fulfillment.</p>
<ul>
  <li>
    <p>
      <strong>company</strong>: (string) The name of the tracking company.
    </p>

    <p>
  For the tracking company names from the
  <a href="#supported-tracking-companies">list below</a>
  Shopify automatically builds tracking URLs for all of the provided tracking numbers,
  which makes the tracking numbers clickable in the interface.
</p>
<p>
  Additionally, for the tracking companies listed on the
  <a href="https://help.shopify.com/en/manual/shipping/understanding-shipping/shipping-carriers#integrated-shipping-carriers">Shipping Carriers help page</a>
  Shopify will automatically update the fulfillment's <code>shipment_status</code> field during the fulfillment process.
</p>
<aside class="note">
  <h4>Note</h4>
  <p>
    Send the tracking company name exactly as written in the list below (capitalization matters).
  </p>
</aside>

<h4 id=supported-tracking-companies>Supported tracking companies</h4>
<p>
  The following tracking companies display for shops located in any country:
</p>
<ul>
  <li><strong>4PX</strong></li>
  <li><strong>AGS</strong></li>
  <li><strong>Amazon Logistics UK</strong></li>
  <li><strong>Amazon Logistics US</strong></li>
  <li><strong>An Post</strong></li>
  <li><strong>Anjun Logistics</strong></li>
  <li><strong>APC</strong></li>
  <li><strong>Asendia USA</strong></li>
  <li><strong>Australia Post</strong></li>
  <li><strong>Bonshaw</strong></li>
  <li><strong>BPost</strong></li>
  <li><strong>BPost International</strong></li>
  <li><strong>Canada Post</strong></li>
  <li><strong>Canpar</strong></li>
  <li><strong>CDL Last Mile</strong></li>
  <li><strong>China Post</strong></li>
  <li><strong>Chronopost</strong></li>
  <li><strong>Chukou1</strong></li>
  <li><strong>Colissimo</strong></li>
  <li><strong>Comingle</strong></li>
  <li><strong>Coordinadora</strong></li>
  <li><strong>Correios</strong></li>
  <li><strong>Correos</strong></li>
  <li><strong>CTT</strong></li>
  <li><strong>CTT Express</strong></li>
  <li><strong>Cyprus Post</strong></li>
  <li><strong>Delnext</strong></li>
  <li><strong>Deutsche Post</strong></li>
  <li><strong>DHL eCommerce</strong></li>
  <li><strong>DHL eCommerce Asia</strong></li>
  <li><strong>DHL Express</strong></li>
  <li><strong>DPD</strong></li>
  <li><strong>DPD Local</strong></li>
  <li><strong>DPD UK</strong></li>
  <li><strong>DTD Express</strong></li>
  <li><strong>DX</strong></li>
  <li><strong>Eagle</strong></li>
  <li><strong>Estes</strong></li>
  <li><strong>Evri</strong></li>
  <li><strong>FedEx</strong></li>
  <li><strong>First Global Logistics</strong></li>
  <li><strong>First Line</strong></li>
  <li><strong>FSC</strong></li>
  <li><strong>Fulfilla</strong></li>
  <li><strong>GLS</strong></li>
  <li><strong>Guangdong Weisuyi Information Technology (WSE)</strong></li>
  <li><strong>Heppner Internationale Spedition GmbH &amp; Co.</strong></li>
  <li><strong>Iceland Post</strong></li>
  <li><strong>IDEX</strong></li>
  <li><strong>Israel Post</strong></li>
  <li><strong>Japan Post (EN)</strong></li>
  <li><strong>Japan Post (JA)</strong></li>
  <li><strong>La Poste</strong></li>
  <li><strong>Lasership</strong></li>
  <li><strong>Latvia Post</strong></li>
  <li><strong>Lietuvos Paštas</strong></li>
  <li><strong>Logisters</strong></li>
  <li><strong>Lone Star Overnight</strong></li>
  <li><strong>M3 Logistics</strong></li>
  <li><strong>Meteor Space</strong></li>
  <li><strong>Mondial Relay</strong></li>
  <li><strong>New Zealand Post</strong></li>
  <li><strong>NinjaVan</strong></li>
  <li><strong>North Russia Supply Chain (Shenzhen) Co.</strong></li>
  <li><strong>OnTrac</strong></li>
  <li><strong>Packeta</strong></li>
  <li><strong>Pago Logistics</strong></li>
  <li><strong>Ping An Da Tengfei Express</strong></li>
  <li><strong>Pitney Bowes</strong></li>
  <li><strong>Portal PostNord</strong></li>
  <li><strong>Poste Italiane</strong></li>
  <li><strong>PostNL</strong></li>
  <li><strong>PostNord DK</strong></li>
  <li><strong>PostNord NO</strong></li>
  <li><strong>PostNord SE</strong></li>
  <li><strong>Purolator</strong></li>
  <li><strong>Qxpress</strong></li>
  <li><strong>Qyun Express</strong></li>
  <li><strong>Royal Mail</strong></li>
  <li><strong>Royal Shipments</strong></li>
  <li><strong>Sagawa (EN)</strong></li>
  <li><strong>Sagawa (JA)</strong></li>
  <li><strong>Sendle</strong></li>
  <li><strong>SF Express</strong></li>
  <li><strong>SFC Fulfillment</strong></li>
  <li><strong>SHREE NANDAN COURIER</strong></li>
  <li><strong>Singapore Post</strong></li>
  <li><strong>Southwest Air Cargo</strong></li>
  <li><strong>StarTrack</strong></li>
  <li><strong>Step Forward Freight</strong></li>
  <li><strong>Swiss Post</strong></li>
  <li><strong>TForce Final Mile</strong></li>
  <li><strong>Tinghao</strong></li>
  <li><strong>TNT</strong></li>
  <li><strong>Toll IPEC</strong></li>
  <li><strong>United Delivery Service</strong></li>
  <li><strong>UPS</strong></li>
  <li><strong>USPS</strong></li>
  <li><strong>Venipak</strong></li>
  <li><strong>We Post</strong></li>
  <li><strong>Whistl</strong></li>
  <li><strong>Wizmo</strong></li>
  <li><strong>WMYC</strong></li>
  <li><strong>Xpedigo</strong></li>
  <li><strong>XPO Logistics</strong></li>
  <li><strong>Yamato (EN)</strong></li>
  <li><strong>Yamato (JA)</strong></li>
  <li><strong>YiFan Express</strong></li>
  <li><strong>YunExpress</strong></li>
</ul>

<p>
  The following tracking companies are displayed for shops located in specific countries:
</p>
<ul>
  <li><strong>Australia</strong>: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics</li>
  <li><strong>Austria</strong>: Österreichische Post</li>
  <li><strong>Bulgaria</strong>: Speedy</li>
  <li><strong>Canada</strong>: Intelcom, BoxKnight, Loomis, GLS</li>
  <li><strong>China</strong>: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC</li>
  <li><strong>Czechia</strong>: Zásilkovna</li>
  <li><strong>Germany</strong>: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS</li>
  <li><strong>Spain</strong>: SEUR</li>
  <li><strong>France</strong>: Colissimo, Mondial Relay, Colis Privé, GLS</li>
  <li><strong>United Kingdom</strong>: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells</li>
  <li><strong>Greece</strong>: ACS Courier</li>
  <li><strong>Hong Kong SAR</strong>: SF Express</li>
  <li><strong>Ireland</strong>: Fastway, DPD Ireland</li>
  <li><strong>India</strong>: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart</li>
  <li><strong>Italy</strong>: BRT, GLS Italy</li>
  <li><strong>Japan</strong>: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物</li>
  <li><strong>Netherlands</strong>: DHL Parcel, DPD</li>
  <li><strong>Norway</strong>: Bring</li>
  <li><strong>Poland</strong>: Inpost</li>
  <li><strong>Turkey</strong>: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo</li>
  <li><strong>United States</strong>: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo</li>
  <li><strong>South Africa</strong>: Fastway, Skynet</li>
</ul>


  </li>
  <li>
    <strong>number</strong>: (string) The tracking number for the fulfillment.
    <p>
      The tracking number will be clickable in the interface if one of the following applies
      (the highest in the list has the highest priority):
    </p>
    <ul>
      <li>
        Tracking URL provided in the <code>url</code> field.
      </li>
      <li>
        <a href="#supported-tracking-companies">Shopify-known tracking company name</a>
        specified in the <code>company</code> field.
        Shopify will build the tracking url automatically based on the tracking number specified.
      </li>
      <li>
        The tracking number has a Shopify-known format.
        Shopify will guess the tracking provider and build the tracking url based on the tracking number format.
        Not all tracking carriers are supported, and multiple tracking carriers may use similarly formatted tracking numbers.
        This can result in an invalid tracking URL.
        It is highly recommended that you send the tracking company and the tracking URL.
      </li>
    </ul>

    <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


  </li>
  <li>
    <p>
      <strong>url</strong>: (string) The URL to track the fulfillment.
    </p>
    <p>
      The tracking URL is displayed in the merchant's admin in the order page.
      The tracking URL is displayed in the shipping confirmation email, which can optionally be sent to the customer.
      When accounts are enabled, it is also displayed in the customer's order history.
    </p>
    <p>
      The URL must be an <a href="https://datatracker.ietf.org/doc/html/rfc3986">RFC 3986</a> and
      <a href="https://datatracker.ietf.org/doc/html/rfc3987">RFC 3987</a>-compliant URI string.
      For example, <code>https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER</code> is a valid URL.
      It includes a scheme (<code>https</code>) and a host (<code>myshipping.com</code>).
      If you do not provide a scheme (<code>http</code> or <code>https</code>), then <code>http</code> will be substituted.
    </p>
  </li>
</ul>


### Responses
#### 201
Creates a fulfillment for one or many fulfillment orders

Examples:
#####             Create a fulfillment with a tracking number of a Shopify unsupported tracking carrier,
            and therefore with a tracking url provided.

Request:
```
POST /admin/api/unstable/fulfillments.json
{"fulfillment":{"line_items_by_fulfillment_order":[{"fulfillment_order_id":1046000816}],"tracking_info":{"number":"MS1562678","url":"https://www.my-shipping-company.com?tracking_number=MS1562678"}}}
```

Response:
```
HTTP/1.1 201 Created
{"fulfillment":{"id":1069019877,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:43-05:00","service":"manual","updated_at":"2025-01-02T11:38:43-05:00","tracking_company":null,"shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":1071823216,"variant_id":389013007,"title":"Crafty Shoes - Red","quantity":1,"sku":"crafty_shoes_red","variant_title":"Small","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":910489600,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Crafty Shoes - Red - Small","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823216","tax_lines":[]}],"tracking_number":"MS1562678","tracking_numbers":["MS1562678"],"tracking_url":"https://www.my-shipping-company.com?tracking_number=MS1562678","tracking_urls":["https://www.my-shipping-company.com?tracking_number=MS1562678"],"receipt":{},"name":"#1001.2","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019877"}}
```
#####             Create a fulfillment with a tracking number provided.
            Tracking url and tracking company name will be determined automatically as the tracking number format
            unambiguously maps to a supported company (UPS).

Request:
```
POST /admin/api/unstable/fulfillments.json
{"fulfillment":{"line_items_by_fulfillment_order":[{"fulfillment_order_id":1046000813}],"tracking_info":{"number":"1Z001985YW99744790"}}}
```

Response:
```
HTTP/1.1 201 Created
{"fulfillment":{"id":1069019871,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:40-05:00","service":"manual","updated_at":"2025-01-02T11:38:40-05:00","tracking_company":"UPS","shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":1071823210,"variant_id":389013007,"title":"Crafty Shoes - Red","quantity":1,"sku":"crafty_shoes_red","variant_title":"Small","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":910489600,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Crafty Shoes - Red - Small","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823210","tax_lines":[]}],"tracking_number":"1Z001985YW99744790","tracking_numbers":["1Z001985YW99744790"],"tracking_url":"https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790","tracking_urls":["https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790"],"receipt":{},"name":"#1001.2","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019871"}}
```
##### Create a fulfillment for all fulfillment order line items if `fulfillment_order_line_items` is left blank
Request:
```
POST /admin/api/unstable/fulfillments.json
{"fulfillment":{"message":"The package was shipped this morning.","notify_customer":false,"tracking_info":{"number":"MS1562678","url":"https://www.my-shipping-company.com?tracking=MS1562678"},"line_items_by_fulfillment_order":[{"fulfillment_order_id":1046000814}]}}
```

Response:
```
HTTP/1.1 201 Created
{"fulfillment":{"id":1069019873,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:41-05:00","service":"manual","updated_at":"2025-01-02T11:38:41-05:00","tracking_company":null,"shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":1071823212,"variant_id":389013007,"title":"Crafty Shoes - Red","quantity":1,"sku":"crafty_shoes_red","variant_title":"Small","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":910489600,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Crafty Shoes - Red - Small","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823212","tax_lines":[]}],"tracking_number":"MS1562678","tracking_numbers":["MS1562678"],"tracking_url":"https://www.my-shipping-company.com?tracking=MS1562678","tracking_urls":["https://www.my-shipping-company.com?tracking=MS1562678"],"receipt":{},"name":"#1001.2","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019873"}}
```
##### Create a fulfillment for the fulfillment order line items specified
Request:
```
POST /admin/api/unstable/fulfillments.json
{"fulfillment":{"message":"The package was shipped this morning.","notify_customer":false,"tracking_info":{"number":"1Z001985YW99744790","company":"UPS"},"line_items_by_fulfillment_order":[{"fulfillment_order_id":1046000811,"fulfillment_order_line_items":[{"id":1072503316,"quantity":1}]}]}}
```

Response:
```
HTTP/1.1 201 Created
{"fulfillment":{"id":1069019868,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:38-05:00","service":"manual","updated_at":"2025-01-02T11:38:38-05:00","tracking_company":"UPS","shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":1071823206,"variant_id":389013007,"title":"Crafty Shoes - Red","quantity":1,"sku":"crafty_shoes_red","variant_title":"Small","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":910489600,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Crafty Shoes - Red - Small","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823206","tax_lines":[]}],"tracking_number":"1Z001985YW99744790","tracking_numbers":["1Z001985YW99744790"],"tracking_url":"https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790","tracking_urls":["https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790"],"receipt":{},"name":"#1001.2","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019868"}}
```
##### Create a fulfillment without tracking info. Tracking numbers can be set later with the <code>/admin/api/API_VERSION/fulfillments/FULFILLMENT_ID/update_tracking.json</code> endpoint.
Request:
```
POST /admin/api/unstable/fulfillments.json
{"fulfillment":{"line_items_by_fulfillment_order":[{"fulfillment_order_id":1046000815}]}}
```

Response:
```
HTTP/1.1 201 Created
{"fulfillment":{"id":1069019875,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:42-05:00","service":"manual","updated_at":"2025-01-02T11:38:42-05:00","tracking_company":null,"shipment_status":null,"location_id":24826418,"origin_address":null,"line_items":[{"id":1071823214,"variant_id":389013007,"title":"Crafty Shoes - Red","quantity":1,"sku":"crafty_shoes_red","variant_title":"Small","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":910489600,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Crafty Shoes - Red - Small","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":0,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823214","tax_lines":[]}],"tracking_number":null,"tracking_numbers":[],"tracking_url":null,"tracking_urls":[],"receipt":{},"name":"#1001.2","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019875"}}
```
## Updates the tracking information for a fulfillment

Updates the tracking information for a fulfillment.

### Endpoint
/admin/api/#{api_version}/fulfillments/{fulfillment_id}/update_tracking.json (POST)

### Parameters
* api_version (required): 
* fulfillment_id (required): 
* tracking_info (required): <p>The tracking information for the fulfillment.</p>
<ul>
  <li>
    <p>
      <strong>company</strong>: (string) The name of the tracking company.
    </p>

    <p>
  For the tracking company names from the
  <a href="#supported-tracking-companies">list below</a>
  Shopify automatically builds tracking URLs for all of the provided tracking numbers,
  which makes the tracking numbers clickable in the interface.
</p>
<p>
  Additionally, for the tracking companies listed on the
  <a href="https://help.shopify.com/en/manual/shipping/understanding-shipping/shipping-carriers#integrated-shipping-carriers">Shipping Carriers help page</a>
  Shopify will automatically update the fulfillment's <code>shipment_status</code> field during the fulfillment process.
</p>
<aside class="note">
  <h4>Note</h4>
  <p>
    Send the tracking company name exactly as written in the list below (capitalization matters).
  </p>
</aside>

<h4 id=supported-tracking-companies>Supported tracking companies</h4>
<p>
  The following tracking companies display for shops located in any country:
</p>
<ul>
  <li><strong>4PX</strong></li>
  <li><strong>AGS</strong></li>
  <li><strong>Amazon Logistics UK</strong></li>
  <li><strong>Amazon Logistics US</strong></li>
  <li><strong>An Post</strong></li>
  <li><strong>Anjun Logistics</strong></li>
  <li><strong>APC</strong></li>
  <li><strong>Asendia USA</strong></li>
  <li><strong>Australia Post</strong></li>
  <li><strong>Bonshaw</strong></li>
  <li><strong>BPost</strong></li>
  <li><strong>BPost International</strong></li>
  <li><strong>Canada Post</strong></li>
  <li><strong>Canpar</strong></li>
  <li><strong>CDL Last Mile</strong></li>
  <li><strong>China Post</strong></li>
  <li><strong>Chronopost</strong></li>
  <li><strong>Chukou1</strong></li>
  <li><strong>Colissimo</strong></li>
  <li><strong>Comingle</strong></li>
  <li><strong>Coordinadora</strong></li>
  <li><strong>Correios</strong></li>
  <li><strong>Correos</strong></li>
  <li><strong>CTT</strong></li>
  <li><strong>CTT Express</strong></li>
  <li><strong>Cyprus Post</strong></li>
  <li><strong>Delnext</strong></li>
  <li><strong>Deutsche Post</strong></li>
  <li><strong>DHL eCommerce</strong></li>
  <li><strong>DHL eCommerce Asia</strong></li>
  <li><strong>DHL Express</strong></li>
  <li><strong>DPD</strong></li>
  <li><strong>DPD Local</strong></li>
  <li><strong>DPD UK</strong></li>
  <li><strong>DTD Express</strong></li>
  <li><strong>DX</strong></li>
  <li><strong>Eagle</strong></li>
  <li><strong>Estes</strong></li>
  <li><strong>Evri</strong></li>
  <li><strong>FedEx</strong></li>
  <li><strong>First Global Logistics</strong></li>
  <li><strong>First Line</strong></li>
  <li><strong>FSC</strong></li>
  <li><strong>Fulfilla</strong></li>
  <li><strong>GLS</strong></li>
  <li><strong>Guangdong Weisuyi Information Technology (WSE)</strong></li>
  <li><strong>Heppner Internationale Spedition GmbH &amp; Co.</strong></li>
  <li><strong>Iceland Post</strong></li>
  <li><strong>IDEX</strong></li>
  <li><strong>Israel Post</strong></li>
  <li><strong>Japan Post (EN)</strong></li>
  <li><strong>Japan Post (JA)</strong></li>
  <li><strong>La Poste</strong></li>
  <li><strong>Lasership</strong></li>
  <li><strong>Latvia Post</strong></li>
  <li><strong>Lietuvos Paštas</strong></li>
  <li><strong>Logisters</strong></li>
  <li><strong>Lone Star Overnight</strong></li>
  <li><strong>M3 Logistics</strong></li>
  <li><strong>Meteor Space</strong></li>
  <li><strong>Mondial Relay</strong></li>
  <li><strong>New Zealand Post</strong></li>
  <li><strong>NinjaVan</strong></li>
  <li><strong>North Russia Supply Chain (Shenzhen) Co.</strong></li>
  <li><strong>OnTrac</strong></li>
  <li><strong>Packeta</strong></li>
  <li><strong>Pago Logistics</strong></li>
  <li><strong>Ping An Da Tengfei Express</strong></li>
  <li><strong>Pitney Bowes</strong></li>
  <li><strong>Portal PostNord</strong></li>
  <li><strong>Poste Italiane</strong></li>
  <li><strong>PostNL</strong></li>
  <li><strong>PostNord DK</strong></li>
  <li><strong>PostNord NO</strong></li>
  <li><strong>PostNord SE</strong></li>
  <li><strong>Purolator</strong></li>
  <li><strong>Qxpress</strong></li>
  <li><strong>Qyun Express</strong></li>
  <li><strong>Royal Mail</strong></li>
  <li><strong>Royal Shipments</strong></li>
  <li><strong>Sagawa (EN)</strong></li>
  <li><strong>Sagawa (JA)</strong></li>
  <li><strong>Sendle</strong></li>
  <li><strong>SF Express</strong></li>
  <li><strong>SFC Fulfillment</strong></li>
  <li><strong>SHREE NANDAN COURIER</strong></li>
  <li><strong>Singapore Post</strong></li>
  <li><strong>Southwest Air Cargo</strong></li>
  <li><strong>StarTrack</strong></li>
  <li><strong>Step Forward Freight</strong></li>
  <li><strong>Swiss Post</strong></li>
  <li><strong>TForce Final Mile</strong></li>
  <li><strong>Tinghao</strong></li>
  <li><strong>TNT</strong></li>
  <li><strong>Toll IPEC</strong></li>
  <li><strong>United Delivery Service</strong></li>
  <li><strong>UPS</strong></li>
  <li><strong>USPS</strong></li>
  <li><strong>Venipak</strong></li>
  <li><strong>We Post</strong></li>
  <li><strong>Whistl</strong></li>
  <li><strong>Wizmo</strong></li>
  <li><strong>WMYC</strong></li>
  <li><strong>Xpedigo</strong></li>
  <li><strong>XPO Logistics</strong></li>
  <li><strong>Yamato (EN)</strong></li>
  <li><strong>Yamato (JA)</strong></li>
  <li><strong>YiFan Express</strong></li>
  <li><strong>YunExpress</strong></li>
</ul>

<p>
  The following tracking companies are displayed for shops located in specific countries:
</p>
<ul>
  <li><strong>Australia</strong>: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics</li>
  <li><strong>Austria</strong>: Österreichische Post</li>
  <li><strong>Bulgaria</strong>: Speedy</li>
  <li><strong>Canada</strong>: Intelcom, BoxKnight, Loomis, GLS</li>
  <li><strong>China</strong>: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC</li>
  <li><strong>Czechia</strong>: Zásilkovna</li>
  <li><strong>Germany</strong>: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS</li>
  <li><strong>Spain</strong>: SEUR</li>
  <li><strong>France</strong>: Colissimo, Mondial Relay, Colis Privé, GLS</li>
  <li><strong>United Kingdom</strong>: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells</li>
  <li><strong>Greece</strong>: ACS Courier</li>
  <li><strong>Hong Kong SAR</strong>: SF Express</li>
  <li><strong>Ireland</strong>: Fastway, DPD Ireland</li>
  <li><strong>India</strong>: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart</li>
  <li><strong>Italy</strong>: BRT, GLS Italy</li>
  <li><strong>Japan</strong>: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物</li>
  <li><strong>Netherlands</strong>: DHL Parcel, DPD</li>
  <li><strong>Norway</strong>: Bring</li>
  <li><strong>Poland</strong>: Inpost</li>
  <li><strong>Turkey</strong>: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo</li>
  <li><strong>United States</strong>: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo</li>
  <li><strong>South Africa</strong>: Fastway, Skynet</li>
</ul>


  </li>
  <li>
    <strong>number</strong>: (string) The tracking number for the fulfillment.
    <p>
      The tracking number will be clickable in the interface if one of the following applies
      (the highest in the list has the highest priority):
    </p>
    <ul>
      <li>
        Tracking URL provided in the <code>url</code> field.
      </li>
      <li>
        <a href="#supported-tracking-companies">Shopify-known tracking company name</a>
        specified in the <code>company</code> field.
        Shopify will build the tracking url automatically based on the tracking number specified.
      </li>
      <li>
        The tracking number has a Shopify-known format.
        Shopify will guess the tracking provider and build the tracking url based on the tracking number format.
        Not all tracking carriers are supported, and multiple tracking carriers may use similarly formatted tracking numbers.
        This can result in an invalid tracking URL.
        It is highly recommended that you send the tracking company and the tracking URL.
      </li>
    </ul>

    <aside class="note">
  <h4>Note</h4>
  <p>
    With the REST API, you can set only one tracking number and one tracking URL per fulfillment.
    If you send multiple shipments with one fulfillment,
    you may want to specify tracking numbers and tracking URLs for all of them.
    You can do it with the equivalent GraphQL
    <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentCreate">fulfillmentCreate</a>
    and <a href="/docs/api/admin-graphql/unstable/mutations/fulfillmentTrackingInfoUpdate">fulfillmentTrackingInfoUpdate</a>
    mutations.
  </p>
</aside>


  </li>
  <li>
    <p>
      <strong>url</strong>: (string) The URL to track the fulfillment.
    </p>
    <p>
      The tracking URL is displayed in the merchant's admin in the order page.
      The tracking URL is displayed in the shipping confirmation email, which can optionally be sent to the customer.
      When accounts are enabled, it is also displayed in the customer's order history.
    </p>
    <p>
      The URL must be an <a href="https://datatracker.ietf.org/doc/html/rfc3986">RFC 3986</a> and
      <a href="https://datatracker.ietf.org/doc/html/rfc3987">RFC 3987</a>-compliant URI string.
      For example, <code>https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER</code> is a valid URL.
      It includes a scheme (<code>https</code>) and a host (<code>myshipping.com</code>).
      If you do not provide a scheme (<code>http</code> or <code>https</code>), then <code>http</code> will be substituted.
    </p>
  </li>
</ul>

* notify_customer: Whether the customer will be notified of this update and future updates for the fulfillment.

### Responses
#### 200
Updates the tracking information for a fulfillment

Examples:
##### Update the tracking information for a fulfillment with a supported tracking company name and a tracking number. Notify the customer about the tracking details provided.
Request:
```
POST /admin/api/unstable/fulfillments/1069019869/update_tracking.json
{"fulfillment":{"notify_customer":true,"tracking_info":{"company":"UPS","number":"1Z001985YW99744790"}}}
```

Response:
```
HTTP/1.1 200 OK
{"fulfillment":{"tracking_company":"UPS","location_id":24826418,"id":1069019869,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:39-05:00","shipment_status":null,"origin_address":{"address1":"150 Elgin St","city":"Ottawa","zip":"K2P 1L4","province_code":"ON","country_code":"CA"},"line_items":[{"id":1071823207,"variant_id":43729076,"title":"Draft","quantity":1,"sku":"draft-151","variant_title":"151cm","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":108828309,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Draft - 151cm","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":1,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823207","tax_lines":[]}],"tracking_number":"1Z001985YW99744790","tracking_numbers":["1Z001985YW99744790"],"tracking_url":"https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790","tracking_urls":["https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z001985YW99744790"],"receipt":{},"name":"#1001.1","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019869"}}
```
##### Update the tracking information for a fulfillment with a tracking number and a tracking url
Request:
```
POST /admin/api/unstable/fulfillments/1069019866/update_tracking.json
{"fulfillment":{"notify_customer":true,"tracking_info":{"number":"1111","url":"http://www.my-url.com"}}}
```

Response:
```
HTTP/1.1 200 OK
{"fulfillment":{"tracking_company":null,"location_id":24826418,"id":1069019866,"order_id":450789469,"status":"success","created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:37-05:00","shipment_status":null,"origin_address":{"address1":"150 Elgin St","city":"Ottawa","zip":"K2P 1L4","province_code":"ON","country_code":"CA"},"line_items":[{"id":1071823203,"variant_id":43729076,"title":"Draft","quantity":1,"sku":"draft-151","variant_title":"151cm","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":108828309,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Draft - 151cm","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":1,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823203","tax_lines":[]}],"tracking_number":"1111","tracking_numbers":["1111"],"tracking_url":"http://www.my-url.com","tracking_urls":["http://www.my-url.com"],"receipt":{},"name":"#1001.1","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019866"}}
```
## Cancels a fulfillment

Cancels a fulfillment.

### Endpoint
/admin/api/#{api_version}/fulfillments/{fulfillment_id}/cancel.json (POST)

### Parameters
* api_version (required): 
* fulfillment_id (required): 

### Responses
#### 200
Cancels a fulfillment

Examples:
##### Cancel a fulfillment
Request:
```
POST /admin/api/unstable/fulfillments/1069019879/cancel.json
{}
```

Response:
```
HTTP/1.1 200 OK
{"fulfillment":{"order_id":450789469,"status":"cancelled","location_id":24826418,"id":1069019879,"created_at":"2025-01-02T11:38:15-05:00","service":"manual","updated_at":"2025-01-02T11:38:45-05:00","tracking_company":"UPS","shipment_status":null,"origin_address":{"address1":"150 Elgin St","city":"Ottawa","zip":"K2P 1L4","province_code":"ON","country_code":"CA"},"line_items":[{"id":1071823217,"variant_id":43729076,"title":"Draft","quantity":1,"sku":"draft-151","variant_title":"151cm","vendor":"Birthday Present Factory","fulfillment_service":"manual","product_id":108828309,"requires_shipping":true,"taxable":true,"gift_card":false,"name":"Draft - 151cm","variant_inventory_management":null,"properties":[],"product_exists":true,"fulfillable_quantity":1,"grams":0,"price":"10.00","total_discount":"0.00","fulfillment_status":"fulfilled","price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_discount_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"discount_allocations":[],"duties":[],"admin_graphql_api_id":"gid://shopify/LineItem/1071823217","tax_lines":[]}],"tracking_number":"#☠1☢\n---\n4321\n","tracking_numbers":["#☠1☢\n---\n4321\n"],"tracking_url":"https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=#☠1☢---4321","tracking_urls":["https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=#☠1☢---4321"],"receipt":{},"name":"#1001.1","admin_graphql_api_id":"gid://shopify/Fulfillment/1069019879"}}
```