Shopify · Schema

Shopify Inventory Item

An inventory item represents the physical goods for a product variant. Inventory items track quantities across locations and contain cost and customs information. Each product variant has a one-to-one relationship with an inventory item.

CommerceE-CommercePaymentsRetailShopping CartT1ShopifyAgentic CommerceUniversal Commerce ProtocolPoint-of-SaleCanada

Properties

Name Type Description
id integer Unique numeric identifier for the inventory item
sku stringnull The stock keeping unit
cost stringnull The unit cost of the inventory item as a decimal string
tracked boolean Whether Shopify tracks inventory quantities for this item
requires_shipping boolean Whether the item requires shipping
country_code_of_origin stringnull The two-letter ISO 3166-1 country code where the item was manufactured
province_code_of_origin stringnull The province or state code where the item was manufactured
harmonized_system_code stringnull The Harmonized System code for customs classification
country_harmonized_system_codes array Country-specific HS codes for customs
created_at string When the inventory item was created
updated_at string When the inventory item was last updated
admin_graphql_api_id string The GraphQL Admin API identifier
View JSON Schema on GitHub

JSON Schema

shopify-inventory-item-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://shopify.dev/schemas/inventory-item.json",
  "title": "Shopify Inventory Item",
  "description": "An inventory item represents the physical goods for a product variant. Inventory items track quantities across locations and contain cost and customs information. Each product variant has a one-to-one relationship with an inventory item.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique numeric identifier for the inventory item"
    },
    "sku": {
      "type": ["string", "null"],
      "description": "The stock keeping unit"
    },
    "cost": {
      "type": ["string", "null"],
      "description": "The unit cost of the inventory item as a decimal string"
    },
    "tracked": {
      "type": "boolean",
      "description": "Whether Shopify tracks inventory quantities for this item"
    },
    "requires_shipping": {
      "type": "boolean",
      "description": "Whether the item requires shipping"
    },
    "country_code_of_origin": {
      "type": ["string", "null"],
      "description": "The two-letter ISO 3166-1 country code where the item was manufactured"
    },
    "province_code_of_origin": {
      "type": ["string", "null"],
      "description": "The province or state code where the item was manufactured"
    },
    "harmonized_system_code": {
      "type": ["string", "null"],
      "description": "The Harmonized System code for customs classification"
    },
    "country_harmonized_system_codes": {
      "type": "array",
      "description": "Country-specific HS codes for customs",
      "items": {
        "type": "object",
        "properties": {
          "harmonized_system_code": {
            "type": "string",
            "description": "The country-specific HS code"
          },
          "country_code": {
            "type": "string",
            "description": "The two-letter ISO country code"
          }
        }
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the inventory item was created"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the inventory item was last updated"
    },
    "admin_graphql_api_id": {
      "type": "string",
      "description": "The GraphQL Admin API identifier"
    }
  },
  "required": ["id"]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/shopify-inventory-item"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.