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.
Inventory
inventory access scope.An inventory item represents a physical good. It holds essential information about the physical good, including its SKU and whether its inventory is tracked.
There is a 1:1 relationship between a product variant and an inventory item. Each product variant includes the ID of its related inventory item. You can use the inventory item ID to query the InventoryLevel resource to retrieve the location and quantity for an inventory item.
Use the InventoryItem resource together with the InventoryLevel and Location resources to manage a store's inventory across multiple locations.
Endpoints
- get/admin/api/latest/inventory_
items. json?ids=808950810,39072856,457924702 Retrieves a detailed list for inventory items by IDs - get/admin/api/latest/inventory_
items/{inventory_ item_ id}. json Retrieves a single inventory item by ID - put/admin/api/latest/inventory_
items/{inventory_ item_ id}. json Updates an existing inventory item
The InventoryItem resource
Properties
The unit cost of the inventory item. The shop's default currency is used.
The country code (ISO 3166-1 alpha-2) of where the item came from.
An array of country-specific Harmonized System (HS) codes for the item. Used to determine duties when shipping the inventory item to certain countries.
The date and time (ISO 8601 format) when the inventory item was created.
The general Harmonized System (HS) code for the inventory item. Used if a country-specific HS code () is not available.
The ID of the inventory item.
The province code (ISO 3166-2 alpha-2) of where the item came from. The province code is only used if the shipping provider for the inventory item is Canada Post.
The unique SKU (stock keeping unit) of the inventory item. Case-sensitive string.
Whether inventory levels are tracked for the item. If true, then the inventory quantity changes are tracked by Shopify.
The date and time (ISO 8601 format) when the inventory item was last modified.
Whether a customer needs to provide a shipping address when placing an order containing the inventory item.
The InventoryItem resource
Anchor to GET request, Retrieves a detailed list for inventory items by IDsgetRetrieves a detailed list for inventory items by IDs
Retrieves a list that will display details for the inventory item IDs you specify. 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 only inventory items specified by a comma-separated list of IDs.
The maximum number of results to show.
Retrieves a detailed list for inventory items by IDs
Retrieves a detailed list for inventory items by IDs
Show only inventory items specified by a comma-separated list of IDs.
/admin/api/2025-07/inventory_
Response
Anchor to GET request, Retrieves a single inventory item by IDgetRetrieves a single inventory item by ID
Retrieves a single inventory item by ID
Retrieve an inventory item by ID
Retrieve an inventory item by ID
/admin/api/2025-07/inventory_
Response
Anchor to PUT request, Updates an existing inventory itemputUpdates an existing inventory item
Updates an existing inventory item
Update an inventory item's SKU
Update an inventory item's SKU
Show inventory_item properties
The ID of the inventory item.
The unique SKU (stock keeping unit) of the inventory item. Case-sensitive string.
Update an inventory item's unit cost
Update an inventory item's unit cost
Show inventory_item properties
The ID of the inventory item.
The unit cost of the inventory item. The shop's default currency is used.