The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the GraphQL Admin API. For details and migration steps, visit our migration guide.
Fulfillment
You can use the Fulfillment
resource to view fulfillments for an order or a fulfillment order.
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 Fulfillment
resource to manage fulfillments for fulfillment orders.

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.
Each fulfillment supports a single tracking number. If you need to use multiple tracking numbers, then you should create separate fulfillments.
Endpoints
- post/admin/api/latest/fulfillments.
json Creates a fulfillment for one or many fulfillment orders - post/admin/api/latest/fulfillments/{fulfillment_
id}/cancel. json Cancels a fulfillment - post/admin/api/latest/fulfillments/{fulfillment_
id}/update_ tracking. json Updates the tracking information for a fulfillment - get/admin/api/latest/fulfillment_
orders/{fulfillment_ order_ id}/fulfillments. json Retrieves fulfillments associated with a fulfillment order - get/admin/api/latest/orders/{order_
id}/fulfillments. json Retrieves fulfillments associated with an order - get/admin/api/latest/orders/{order_
id}/fulfillments/{fulfillment_ id}. json Receive a single Fulfillment - get/admin/api/latest/orders/{order_
id}/fulfillments/count. json Retrieves a count of fulfillments associated with a specific order
The Fulfillment resource
Properties
The date and time when the fulfillment was created. The API returns this value in ISO 8601 format.
The ID for the fulfillment.
A list of the fulfillment's line items, which includes:
Show line_items properties
- id: The ID of the line item within the fulfillment.
- variant_id: The ID of the product variant being fulfilled.
- title: The title of the product.
- quantity: The number of items in the fulfillment.
- price: The price of the item before discounts have been applied in the shop currency.
- price_set: The price of the line item in shop and presentment currencies.
- grams: The weight of the item in grams.
- sku: The unique identifier of the item in the fulfillment.
- variant_title: The title of the product variant being fulfilled.
- vendor: The name of the supplier of the item.
- fulfillment_service: The service provider who is doing the fulfillment. This field will be deprecated. Use the
assigned_location
property on theFulfillmentOrder
resource instead. - product_id: The unique numeric identifier for the product in the fulfillment.
- requires_shipping: Whether a customer needs to provide a shipping address when placing an order for this product variant.
- taxable: Whether the line item is taxable.
- gift_card: Whether the line item is a gift card.
- name: The name of the product variant.
- variant_inventory_management: The name of the inventory management system.
- properties: Any additional properties associated with the line item.
- product_exists: Whether the product exists.
- fulfillable_quantity: 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
fulfillable_quantity
property of theline_item
property on theFulfillmentOrder
resource instead. - total_discount: 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
discount_allocations
, which provides the same information. - fulfillment_status: The status of an order in terms of the line items being fulfilled. Valid values:
fulfilled
,null
, orpartial
. This field will be deprecated. Use thestatus
property on theFulfillmentOrder
resource instead. - total_discount_set: The total amount allocated to the line item in the presentment currency. Instead of using this field, Shopify recommends using
discount_allocations
, which provides the same information. -
discount_allocations: 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.
amount
: The discount amount allocated to the line in the shop currency.discount_application_index
: The index of the associated discount application in the order'sdiscount_applications
list.amount_set
: The discount amount allocated to the line item in shop and presentment currencies.
- fulfillment_line_item_id: A unique identifier for a quantity of items within a single fulfillment. An order can have multiple fulfillment line items.
- tax_lines: The
title
,price
, andrate
of any taxes applied to the line item for its total quantity on the order. - duties: A list of duty objects, each containing information about a duty on the line item for its total quantity on the order.
The unique identifier of the location that the fulfillment was processed at. To find the ID of the location, use the Location resource.
The uniquely identifying fulfillment name, consisting of two parts separated by a .
. 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. #1001.1
, #1001.2
).
The unique numeric identifier for the order.
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 assigned_location
` property on the
FulfillmentOrder resource instead.
Show origin_address properties
- address1: (string) The street address of the fulfillment location.
- address2: (string) The second line of the address. Typically the number of the apartment, suite, or unit.
- city: (string) The city of the fulfillment location.
- country_code: (string) (required) The two-letter country code (ISO 3166-1 alpha-2 format) of the fulfillment location.
- province_code: (string) The province of the fulfillment location.
- zip: (string) The zip code of the fulfillment location.
A text field that provides information about the receipt:
Show receipt properties
- testcase: Whether the fulfillment was a testcase.
- authorization: The authorization code.
The fulfillment service associated with the fulfillment.
The current shipment status of the fulfillment. Valid values:
Show shipment_status properties
- label_printed: A label for the shipment was purchased and printed.
- label_purchased: A label for the shipment was purchased, but not printed.
- attempted_delivery: Delivery of the shipment was attempted, but unable to be completed.
- ready_for_pickup: The shipment is ready for pickup at a shipping depot.
- confirmed: The carrier is aware of the shipment, but hasn't received it yet.
- in_transit: The shipment is being transported between shipping facilities on the way to its destination.
- out_for_delivery: The shipment is being delivered to its final destination.
- delivered: The shipment was succesfully delivered.
- failure: Something went wrong when pulling tracking information for the shipment, such as the tracking number was invalid or the shipment was canceled.
The status of the fulfillment. Valid values:
Show status properties
- pending: Shopify has created the fulfillment and is waiting for the third-party fulfillment service to transition it to 'open' or 'success'.
- open: The fulfillment has been acknowledged by the service and is in processing.
- success: The fulfillment was successful.
- cancelled: The fulfillment was cancelled.
- error: There was an error with the fulfillment request.
- failure: The fulfillment request failed.
The name of the tracking company.
For the tracking company names from the list below Shopify automatically builds tracking URLs for all of the provided tracking numbers, which makes the tracking numbers clickable in the interface.
Additionally, for the tracking companies listed on the
Shipping Carriers help page
Shopify will automatically update the fulfillment's shipment_status
field during the fulfillment process.
Send the tracking company name exactly as written in the list below (capitalization matters).
Supported tracking companies
The following tracking companies display for shops located in any country:
Show tracking_company properties
- 4PX
- AGS
- Amazon Logistics UK
- Amazon Logistics US
- An Post
- Anjun Logistics
- APC
- Asendia USA
- Australia Post
- Bonshaw
- BPost
- BPost International
- Canada Post
- Canpar
- CDL Last Mile
- China Post
- Chronopost
- Chukou1
- Colissimo
- Comingle
- Coordinadora
- Correios
- Correos
- CTT
- CTT Express
- Cyprus Post
- Delnext
- Deutsche Post
- DHL eCommerce
- DHL eCommerce Asia
- DHL Express
- DPD
- DPD Local
- DPD UK
- DTD Express
- DX
- Eagle
- Estes
- Evri
- FedEx
- First Global Logistics
- First Line
- FSC
- Fulfilla
- GLS
- Guangdong Weisuyi Information Technology (WSE)
- Heppner Internationale Spedition GmbH & Co.
- Iceland Post
- IDEX
- Israel Post
- Japan Post (EN)
- Japan Post (JA)
- La Poste
- Lasership
- Latvia Post
- Lietuvos Paštas
- Logisters
- Lone Star Overnight
- M3 Logistics
- Meteor Space
- Mondial Relay
- New Zealand Post
- NinjaVan
- North Russia Supply Chain (Shenzhen) Co.
- OnTrac
- Packeta
- Pago Logistics
- Ping An Da Tengfei Express
- Pitney Bowes
- Portal PostNord
- Poste Italiane
- PostNL
- PostNord DK
- PostNord NO
- PostNord SE
- Purolator
- Qxpress
- Qyun Express
- Royal Mail
- Royal Shipments
- Sagawa (EN)
- Sagawa (JA)
- Sendle
- SF Express
- SFC Fulfillment
- SHREE NANDAN COURIER
- Singapore Post
- Southwest Air Cargo
- StarTrack
- Step Forward Freight
- Swiss Post
- TForce Final Mile
- Tinghao
- TNT
- Toll IPEC
- United Delivery Service
- UPS
- USPS
- Venipak
- We Post
- Whistl
- Wizmo
- WMYC
- Xpedigo
- XPO Logistics
- Yamato (EN)
- Yamato (JA)
- YiFan Express
- YunExpress
The following tracking companies are displayed for shops located in specific countries:
- Australia: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics
- Austria: Österreichische Post
- Bulgaria: Speedy
- Canada: Intelcom, BoxKnight, Loomis, GLS
- China: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC
- Czechia: Zásilkovna
- Germany: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS
- Spain: SEUR
- France: Colissimo, Mondial Relay, Colis Privé, GLS
- United Kingdom: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells
- Greece: ACS Courier
- Hong Kong SAR: SF Express
- Ireland: Fastway, DPD Ireland
- India: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart
- Italy: BRT, GLS Italy
- Japan: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物
- Netherlands: DHL Parcel, DPD
- Norway: Bring
- Poland: Inpost
- Turkey: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo
- United States: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo
- South Africa: Fastway, Skynet
The Fulfillment resource
Anchor to POST request, Creates a fulfillment for one or many fulfillment orderspostCreates 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.
The fulfillment order line items that have to be fulfilled.
Show line_items_by_fulfillment_order properties
- fulfillment_order_id: (integer) (required) The ID of the fulfillment order.
-
fulfillment_order_line_items: (array) The fulfillment order line items and the quantity of each which should be fulfilled.
If this property is
undefined
, then all of the fulfillment order line items of the associated fulfillment order are fulfilled.- id: (integer) (required) The ID of the fulfillment order line item.
- quantity: (integer) (required) (minimum: 1) The quantity of the fulfillment order line item.
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.
Whether the customer should be notified.
If set to true
, then an email will be sent when the fulfillment is created or updated.
The default value is false
.
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 assigned_location
` property on the
FulfillmentOrder resource instead.
Show origin_address properties
- address1: (string) The street address of the fulfillment location.
- address2: (string) The second line of the address. Typically the number of the apartment, suite, or unit.
- city: (string) The city of the fulfillment location.
- country_code: (string) (required) The two-letter country code (ISO 3166-1 alpha-2 format) of the fulfillment location.
- province_code: (string) The province of the fulfillment location.
- zip: (string) The zip code of the fulfillment location.
The tracking information for the fulfillment.
Show tracking_info properties
-
company: (string) The name of the tracking company.
For the tracking company names from the list below Shopify automatically builds tracking URLs for all of the provided tracking numbers, which makes the tracking numbers clickable in the interface.
Additionally, for the tracking companies listed on the Shipping Carriers help page Shopify will automatically update the fulfillment's
shipment_status
field during the fulfillment process.NoteSend the tracking company name exactly as written in the list below (capitalization matters).
Supported tracking companies
The following tracking companies display for shops located in any country:
- 4PX
- AGS
- Amazon Logistics UK
- Amazon Logistics US
- An Post
- Anjun Logistics
- APC
- Asendia USA
- Australia Post
- Bonshaw
- BPost
- BPost International
- Canada Post
- Canpar
- CDL Last Mile
- China Post
- Chronopost
- Chukou1
- Colissimo
- Comingle
- Coordinadora
- Correios
- Correos
- CTT
- CTT Express
- Cyprus Post
- Delnext
- Deutsche Post
- DHL eCommerce
- DHL eCommerce Asia
- DHL Express
- DPD
- DPD Local
- DPD UK
- DTD Express
- DX
- Eagle
- Estes
- Evri
- FedEx
- First Global Logistics
- First Line
- FSC
- Fulfilla
- GLS
- Guangdong Weisuyi Information Technology (WSE)
- Heppner Internationale Spedition GmbH & Co.
- Iceland Post
- IDEX
- Israel Post
- Japan Post (EN)
- Japan Post (JA)
- La Poste
- Lasership
- Latvia Post
- Lietuvos Paštas
- Logisters
- Lone Star Overnight
- M3 Logistics
- Meteor Space
- Mondial Relay
- New Zealand Post
- NinjaVan
- North Russia Supply Chain (Shenzhen) Co.
- OnTrac
- Packeta
- Pago Logistics
- Ping An Da Tengfei Express
- Pitney Bowes
- Portal PostNord
- Poste Italiane
- PostNL
- PostNord DK
- PostNord NO
- PostNord SE
- Purolator
- Qxpress
- Qyun Express
- Royal Mail
- Royal Shipments
- Sagawa (EN)
- Sagawa (JA)
- Sendle
- SF Express
- SFC Fulfillment
- SHREE NANDAN COURIER
- Singapore Post
- Southwest Air Cargo
- StarTrack
- Step Forward Freight
- Swiss Post
- TForce Final Mile
- Tinghao
- TNT
- Toll IPEC
- United Delivery Service
- UPS
- USPS
- Venipak
- We Post
- Whistl
- Wizmo
- WMYC
- Xpedigo
- XPO Logistics
- Yamato (EN)
- Yamato (JA)
- YiFan Express
- YunExpress
The following tracking companies are displayed for shops located in specific countries:
- Australia: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics
- Austria: Österreichische Post
- Bulgaria: Speedy
- Canada: Intelcom, BoxKnight, Loomis, GLS
- China: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC
- Czechia: Zásilkovna
- Germany: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS
- Spain: SEUR
- France: Colissimo, Mondial Relay, Colis Privé, GLS
- United Kingdom: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells
- Greece: ACS Courier
- Hong Kong SAR: SF Express
- Ireland: Fastway, DPD Ireland
- India: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart
- Italy: BRT, GLS Italy
- Japan: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物
- Netherlands: DHL Parcel, DPD
- Norway: Bring
- Poland: Inpost
- Turkey: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo
- United States: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo
- South Africa: Fastway, Skynet
-
number: (string) The tracking number for the fulfillment.
The tracking number will be clickable in the interface if one of the following applies (the highest in the list has the highest priority):
-
Tracking URL provided in the
url
field. -
Shopify-known tracking company name
specified in the
company
field. Shopify will build the tracking url automatically based on the tracking number specified. - 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.
NoteWith 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 fulfillmentCreate and fulfillmentTrackingInfoUpdate mutations.
-
Tracking URL provided in the
-
url: (string) The URL to track the fulfillment.
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.
The URL must be an RFC 3986 and RFC 3987-compliant URI string. For example,
https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER
is a valid URL. It includes a scheme (https
) and a host (myshipping.com
). If you do not provide a scheme (http
orhttps
), thenhttp
will be substituted.
Create a fulfillment with a tracking number of a Shopify unsupported tracking carrier,
and therefore with a tracking url provided.
Create a fulfillment with a tracking number of a Shopify unsupported tracking carrier, and therefore with a tracking url provided.
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).
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).
Create a fulfillment for all fulfillment order line items if
is left blank
Create a fulfillment for all fulfillment order line items if is left blank
Create a fulfillment for the fulfillment order line items specified
Create a fulfillment for the fulfillment order line items specified
Create a fulfillment without tracking info. Tracking numbers can be set later with the /admin/api/API_VERSION/fulfillments/FULFILLMENT_ID/update_tracking.json
endpoint.
Create a fulfillment without tracking info. Tracking numbers can be set later with the /admin/api/API_VERSION/fulfillments/FULFILLMENT_ID/update_tracking.json
endpoint.
/admin/api/2025-07/fulfillments. json
Response
Anchor to POST request, Cancels a fulfillmentpostCancels a fulfillment
Cancels a fulfillment.
Cancel a fulfillment
Cancel a fulfillment
/admin/api/2025-07/fulfillments/1069019865/cancel. json
Response
Anchor to POST request, Updates the tracking information for a fulfillmentpostUpdates the tracking information for a fulfillment
Updates the tracking information for a fulfillment.
The tracking information for the fulfillment.
Show tracking_info properties
-
company: (string) The name of the tracking company.
For the tracking company names from the list below Shopify automatically builds tracking URLs for all of the provided tracking numbers, which makes the tracking numbers clickable in the interface.
Additionally, for the tracking companies listed on the Shipping Carriers help page Shopify will automatically update the fulfillment's
shipment_status
field during the fulfillment process.NoteSend the tracking company name exactly as written in the list below (capitalization matters).
Supported tracking companies
The following tracking companies display for shops located in any country:
- 4PX
- AGS
- Amazon Logistics UK
- Amazon Logistics US
- An Post
- Anjun Logistics
- APC
- Asendia USA
- Australia Post
- Bonshaw
- BPost
- BPost International
- Canada Post
- Canpar
- CDL Last Mile
- China Post
- Chronopost
- Chukou1
- Colissimo
- Comingle
- Coordinadora
- Correios
- Correos
- CTT
- CTT Express
- Cyprus Post
- Delnext
- Deutsche Post
- DHL eCommerce
- DHL eCommerce Asia
- DHL Express
- DPD
- DPD Local
- DPD UK
- DTD Express
- DX
- Eagle
- Estes
- Evri
- FedEx
- First Global Logistics
- First Line
- FSC
- Fulfilla
- GLS
- Guangdong Weisuyi Information Technology (WSE)
- Heppner Internationale Spedition GmbH & Co.
- Iceland Post
- IDEX
- Israel Post
- Japan Post (EN)
- Japan Post (JA)
- La Poste
- Lasership
- Latvia Post
- Lietuvos Paštas
- Logisters
- Lone Star Overnight
- M3 Logistics
- Meteor Space
- Mondial Relay
- New Zealand Post
- NinjaVan
- North Russia Supply Chain (Shenzhen) Co.
- OnTrac
- Packeta
- Pago Logistics
- Ping An Da Tengfei Express
- Pitney Bowes
- Portal PostNord
- Poste Italiane
- PostNL
- PostNord DK
- PostNord NO
- PostNord SE
- Purolator
- Qxpress
- Qyun Express
- Royal Mail
- Royal Shipments
- Sagawa (EN)
- Sagawa (JA)
- Sendle
- SF Express
- SFC Fulfillment
- SHREE NANDAN COURIER
- Singapore Post
- Southwest Air Cargo
- StarTrack
- Step Forward Freight
- Swiss Post
- TForce Final Mile
- Tinghao
- TNT
- Toll IPEC
- United Delivery Service
- UPS
- USPS
- Venipak
- We Post
- Whistl
- Wizmo
- WMYC
- Xpedigo
- XPO Logistics
- Yamato (EN)
- Yamato (JA)
- YiFan Express
- YunExpress
The following tracking companies are displayed for shops located in specific countries:
- Australia: Australia Post, Sendle, Aramex Australia, TNT Australia, Hunter Express, Couriers Please, Bonds, Allied Express, Direct Couriers, Northline, GO Logistics
- Austria: Österreichische Post
- Bulgaria: Speedy
- Canada: Intelcom, BoxKnight, Loomis, GLS
- China: China Post, DHL eCommerce Asia, WanbExpress, YunExpress, Anjun Logistics, SFC Fulfillment, FSC
- Czechia: Zásilkovna
- Germany: Deutsche Post (DE), Deutsche Post (EN), DHL, DHL Express, Swiship, Hermes, GLS
- Spain: SEUR
- France: Colissimo, Mondial Relay, Colis Privé, GLS
- United Kingdom: Evri, DPD UK, Parcelforce, Yodel, DHL Parcel, Tuffnells
- Greece: ACS Courier
- Hong Kong SAR: SF Express
- Ireland: Fastway, DPD Ireland
- India: DTDC, India Post, Delhivery, Gati KWE, Professional Couriers, XpressBees, Ecom Express, Ekart, Shadowfax, Bluedart
- Italy: BRT, GLS Italy
- Japan: エコ配, 西濃運輸, 西濃スーパーエキスプレス, 福山通運, 日本通運, 名鉄運輸, 第一貨物
- Netherlands: DHL Parcel, DPD
- Norway: Bring
- Poland: Inpost
- Turkey: PTT, Yurtiçi Kargo, Aras Kargo, Sürat Kargo
- United States: GLS, Alliance Air Freight, Pilot Freight, LSO, Old Dominion, R+L Carriers, Southwest Air Cargo
- South Africa: Fastway, Skynet
-
number: (string) The tracking number for the fulfillment.
The tracking number will be clickable in the interface if one of the following applies (the highest in the list has the highest priority):
-
Tracking URL provided in the
url
field. -
Shopify-known tracking company name
specified in the
company
field. Shopify will build the tracking url automatically based on the tracking number specified. - 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.
NoteWith 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 fulfillmentCreate and fulfillmentTrackingInfoUpdate mutations.
-
Tracking URL provided in the
-
url: (string) The URL to track the fulfillment.
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.
The URL must be an RFC 3986 and RFC 3987-compliant URI string. For example,
https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER
is a valid URL. It includes a scheme (https
) and a host (myshipping.com
). If you do not provide a scheme (http
orhttps
), thenhttp
will be substituted.
Whether the customer will be notified of this update and future updates for the fulfillment.
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.
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.
Update the tracking information for a fulfillment with a tracking number and a tracking url
Update the tracking information for a fulfillment with a tracking number and a tracking url
/admin/api/2025-07/fulfillments/1069019862/update_ tracking. json
Response
Anchor to GET request, Retrieves fulfillments associated with a fulfillment ordergetRetrieves fulfillments associated with a fulfillment order
Retrieves fulfillments associated with a fulfillment order.
The ID of the fulfillment order that is associated with the fulfillments.
Retrieve a list of all fulfillments for a fulfillment order
Retrieve a list of all fulfillments for a fulfillment order
/admin/api/2025-07/fulfillment_ orders/1046000801/fulfillments. json
Response
Anchor to GET request, Retrieves fulfillments associated with an ordergetRetrieves fulfillments associated with an order
orders
, marketplace_orders
.Retrieves fulfillments associated with an order. Note: This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to Make paginated requests to the REST Admin API.
Show fulfillments created before date (format: 2014-04-25T16:15:47-04:00).
Show fulfillments created after date (format: 2014-04-25T16:15:47-04:00).
A comma-separated list of fields to include in the response.
Limit the amount of results.
Restrict results to after the specified ID.
Show fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00).
Show fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00).
Retrieve a list of all fulfillments for an order
Retrieve a list of all fulfillments for an order
Retrieve all fulfillments after the specified ID
Retrieve all fulfillments after the specified ID
Restrict results to after the specified ID.
/admin/api/2025-07/orders/450789469/fulfillments. json
Response
Anchor to GET request, Receive a single FulfillmentgetReceive a single Fulfillment
orders
, marketplace_orders
.Retrieve a specific fulfillment
Comma-separated list of fields to include in the response.
Retrieve a specific fulfillment
Retrieve a specific fulfillment
/admin/api/2025-07/orders/450789469/fulfillments/255858046. json
Response
Anchor to GET request, Retrieves a count of fulfillments associated with a specific ordergetRetrieves a count of fulfillments associated with a specific order
orders
access scope.Retrieves a count of fulfillments associated with a specific order
Count fulfillments created before date (format: 2014-04-25T16:15:47-04:00).
Count fulfillments created after date (format: 2014-04-25T16:15:47-04:00).
Count fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00).
Count fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00).
Count the total number of fulfillments for an order
Count the total number of fulfillments for an order