InventoryItem - admin-graphql - OBJECT

Version: 2024-10

Description:

Represents the goods available to be shipped to a customer. It holds essential information about the goods, including SKU and whether it is tracked. Learn [more about the relationships between inventory objects](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).

Access Scopes

`read_inventory` access scope.

Fields

• countryCodeOfOrigin: CountryCode - The ISO 3166-1 alpha-2 country code of where the item originated from.
• createdAt: DateTime! - The date and time when the inventory item was created.
• duplicateSkuCount: Int! - The number of inventory items that share the same SKU with this item.
• harmonizedSystemCode: String - The harmonized system code of the item.
• id: ID! - A globally-unique ID.
• inventoryHistoryUrl: URL - The URL that points to the inventory history for the item.
• inventoryLevel: InventoryLevel - The inventory item's quantities at the specified location.
• legacyResourceId: UnsignedInt64! - The ID of the corresponding resource in the REST Admin API.
• locationsCount: Count - The number of locations where this inventory item is stocked.
• measurement: InventoryItemMeasurement! - The packaging dimensions of the inventory item.
• provinceCodeOfOrigin: String - The ISO 3166-2 alpha-2 province code of where the item originated from.
• requiresShipping: Boolean! - Whether the inventory item requires shipping.
• sku: String - Inventory item SKU. Case-sensitive string.
• tracked: Boolean! - Whether inventory levels are tracked for the item.
• trackedEditable: EditableProperty! - Whether the value of the `tracked` field for the inventory item can be changed.
• unitCost: MoneyV2 - Unit cost associated with the inventory item. Note: the user must have "View product costs" permission granted in order to access this field once product granular permissions are enabled.
• updatedAt: DateTime! - The date and time when the inventory item was updated.
• variant: ProductVariant! - The variant that owns this inventory item.

Connections

• countryHarmonizedSystemCodes: CountryHarmonizedSystemCodeConnection!
• inventoryLevels: InventoryLevelConnection!

Related queries

• inventoryItem Returns an [InventoryItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) object by ID.
• inventoryItems Returns a list of inventory items.

Related mutations

• inventoryBulkToggleActivation Modify the activation status of an inventory item at locations. Activating an inventory item at a particular location allows that location to stock that inventory item. Deactivating an inventory item at a location removes the inventory item's quantities and turns off the inventory item from that location.
• inventoryItemUpdate Updates an inventory item.

Related Unions

Examples

• Get details about a specified inventory item

          Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query inventoryItem { inventoryItem(id: \\\"gid://shopify/InventoryItem/30322695\\\") { id tracked sku } }\"\n}'\n"
          Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n  data: `query inventoryItem {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      tracked\n      sku\n    }\n  }`,\n});\n"
          Ruby example: "session = ShopifyAPI::Auth::Session.new(\n  shop: \"your-development-store.myshopify.com\",\n  access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n  session: session\n)\n\nquery = <<~QUERY\n  query inventoryItem {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      tracked\n      sku\n    }\n  }\nQUERY\n\nresponse = client.query(query: query)\n"
          PHP example: "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n  query inventoryItem {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      tracked\n      sku\n    }\n  }\nQUERY;\n\n$response = $client->query([\"query\" => $query]);\n"
          Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n  `#graphql\n  query inventoryItem {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      tracked\n      sku\n    }\n  }`,\n);\n\nconst data = await response.json();\n"
          Graphql query: "query inventoryItem {\n  inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n    id\n    tracked\n    sku\n  }\n}"
        

  input: null

  response: {
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/30322695",
        "tracked": true,
        "sku": "element-151"
      }
    }
  }

  Get inventory item levels and product/variant information

          Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query inventoryItemToProductVariant { inventoryItem(id: \\\"gid://shopify/InventoryItem/30322695\\\") { id inventoryLevels(first: 1) { edges { node { id location { id name } quantities(names: [\\\"available\\\", \\\"committed\\\", \\\"incoming\\\", \\\"on_hand\\\", \\\"reserved\\\"]) { name quantity } } } } variant { id title product { id title } } } }\"\n}'\n"
          Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n  data: `query inventoryItemToProductVariant {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      inventoryLevels(first: 1) {\n        edges {\n          node {\n            id\n            location {\n              id\n              name\n            }\n            quantities(names: [\"available\", \"committed\", \"incoming\", \"on_hand\", \"reserved\"]) {\n              name\n              quantity\n            }\n          }\n        }\n      }\n      variant {\n        id\n        title\n        product {\n          id\n          title\n        }\n      }\n    }\n  }`,\n});\n"
          Ruby example: "session = ShopifyAPI::Auth::Session.new(\n  shop: \"your-development-store.myshopify.com\",\n  access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n  session: session\n)\n\nquery = <<~QUERY\n  query inventoryItemToProductVariant {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      inventoryLevels(first: 1) {\n        edges {\n          node {\n            id\n            location {\n              id\n              name\n            }\n            quantities(names: [\"available\", \"committed\", \"incoming\", \"on_hand\", \"reserved\"]) {\n              name\n              quantity\n            }\n          }\n        }\n      }\n      variant {\n        id\n        title\n        product {\n          id\n          title\n        }\n      }\n    }\n  }\nQUERY\n\nresponse = client.query(query: query)\n"
          PHP example: "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n  query inventoryItemToProductVariant {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      inventoryLevels(first: 1) {\n        edges {\n          node {\n            id\n            location {\n              id\n              name\n            }\n            quantities(names: [\"available\", \"committed\", \"incoming\", \"on_hand\", \"reserved\"]) {\n              name\n              quantity\n            }\n          }\n        }\n      }\n      variant {\n        id\n        title\n        product {\n          id\n          title\n        }\n      }\n    }\n  }\nQUERY;\n\n$response = $client->query([\"query\" => $query]);\n"
          Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n  `#graphql\n  query inventoryItemToProductVariant {\n    inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n      id\n      inventoryLevels(first: 1) {\n        edges {\n          node {\n            id\n            location {\n              id\n              name\n            }\n            quantities(names: [\"available\", \"committed\", \"incoming\", \"on_hand\", \"reserved\"]) {\n              name\n              quantity\n            }\n          }\n        }\n      }\n      variant {\n        id\n        title\n        product {\n          id\n          title\n        }\n      }\n    }\n  }`,\n);\n\nconst data = await response.json();\n"
          Graphql query: "query inventoryItemToProductVariant {\n  inventoryItem(id: \"gid://shopify/InventoryItem/30322695\") {\n    id\n    inventoryLevels(first: 1) {\n      edges {\n        node {\n          id\n          location {\n            id\n            name\n          }\n          quantities(names: [\"available\", \"committed\", \"incoming\", \"on_hand\", \"reserved\"]) {\n            name\n            quantity\n          }\n        }\n      }\n    }\n    variant {\n      id\n      title\n      product {\n        id\n        title\n      }\n    }\n  }\n}"
        

  input: null

  response: {
    "data": {
      "inventoryItem": {
        "id": "gid://shopify/InventoryItem/30322695",
        "inventoryLevels": {
          "edges": [
            {
              "node": {
                "id": "gid://shopify/InventoryLevel/523463154?inventory_item_id=30322695",
                "location": {
                  "id": "gid://shopify/Location/346779380",
                  "name": "Ottawa Store"
                },
                "quantities": [
                  {
                    "name": "available",
                    "quantity": 2
                  },
                  {
                    "name": "committed",
                    "quantity": 1
                  },
                  {
                    "name": "incoming",
                    "quantity": 0
                  },
                  {
                    "name": "on_hand",
                    "quantity": 33
                  },
                  {
                    "name": "reserved",
                    "quantity": 30
                  }
                ]
              }
            }
          ]
        },
        "variant": {
          "id": "gid://shopify/ProductVariant/30322695",
          "title": "151cm",
          "product": {
            "id": "gid://shopify/Product/20995642",
            "title": "Element"
          }
        }
      }
    }
  }