Item

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-item-schema.json",
  "title": "Item",
  "description": "An item in the Amazon catalog.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-catalog-api-openapi.yml#/components/schemas/Item",
  "properties": {
    "asin": {
      "$ref": "#/$defs/ItemAsin"
    },
    "attributes": {
      "$ref": "#/$defs/ItemAttributes"
    },
    "classifications": {
      "$ref": "#/$defs/ItemBrowseClassifications"
    },
    "dimensions": {
      "$ref": "#/$defs/ItemDimensions"
    },
    "identifiers": {
      "$ref": "#/$defs/ItemIdentifiers"
    },
    "images": {
      "$ref": "#/$defs/ItemImages"
    },
    "productTypes": {
      "$ref": "#/$defs/ItemProductTypes"
    },
    "relationships": {
      "$ref": "#/$defs/ItemRelationships"
    },
    "salesRanks": {
      "$ref": "#/$defs/ItemSalesRanks"
    },
    "summaries": {
      "$ref": "#/$defs/ItemSummaries"
    },
    "vendorDetails": {
      "$ref": "#/$defs/ItemVendorDetails"
    }
  },
  "required": [
    "asin"
  ],
  "type": "object",
  "$defs": {
    "Dimension": {
      "description": "The value of an individual dimension for an Amazon catalog item or item package.",
      "properties": {
        "unit": {
          "description": "Unit of measurement for the dimension value.",
          "type": "string"
        },
        "value": {
          "description": "Numeric value of the dimension.",
          "type": "number"
        }
      },
      "type": "object"
    },
    "Dimensions": {
      "description": "Dimensions of an Amazon catalog item or item in its packaging.",
      "properties": {
        "height": {
          "description": "Height of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "length": {
          "description": "Length of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "weight": {
          "description": "Weight of an item or item package.",
          "$ref": "#/$defs/Dimension"
        },
        "width": {
          "description": "Width of an item or item package.",
          "$ref": "#/$defs/Dimension"
        }
      },
      "type": "object"
    },
    "ItemAsin": {
      "description": "The unique identifier of an item in the Amazon catalog.",
      "type": "string"
    },
    "ItemAttributes": {
      "description": "A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01).",
      "additionalProperties": true,
      "type": "object"
    },
    "ItemBrowseClassification": {
      "description": "Classification (browse node) for an Amazon catalog item.",
      "properties": {
        "displayName": {
          "description": "Display name for the classification.",
          "type": "string"
        },
        "classificationId": {
          "description": "Identifier of the classification.",
          "type": "string"
        },
        "parent": {
          "description": "Parent classification of the current classification.",
          "$ref": "#/$defs/ItemBrowseClassification"
        }
      },
      "required": [
        "displayName",
        "classificationId"
      ],
      "type": "object"
    },
    "ItemBrowseClassifications": {
      "description": "An array of classifications (browse nodes) that is associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "items": {
        "$ref": "#/$defs/ItemBrowseClassificationsByMarketplace"
      },
      "type": "array"
    },
    "ItemBrowseClassificationsByMarketplace": {
      "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "classifications": {
          "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog.",
          "items": {
            "$ref": "#/$defs/ItemBrowseClassification"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemClassificationSalesRank": {
      "description": "Sales rank of an Amazon catalog item.",
      "properties": {
        "classificationId": {
          "description": "Identifier of the classification that is associated with the sales rank.",
          "type": "string"
        },
        "title": {
          "description": "Name of the sales rank.",
          "type": "string"
        },
        "link": {
          "description": "Corresponding Amazon retail website URL for the sales category.",
          "type": "string"
        },
        "rank": {
          "description": "Sales rank.",
          "type": "integer"
        }
      },
      "required": [
        "classificationId",
        "title",
        "rank"
      ],
      "type": "object"
    },
    "ItemContributor": {
      "description": "Individual contributor to the creation of an item, such as an author or actor.",
      "properties": {
        "role": {
          "$ref": "#/$defs/ItemContributorRole"
        },
        "value": {
          "description": "Name of the contributor, such as `Jane Austen`.",
          "type": "string"
        }
      },
      "required": [
        "value",
        "role"
      ],
      "type": "object"
    },
    "ItemContributorRole": {
      "description": "Role of an individual contributor in the creation of an item, such as author or actor.",
      "properties": {
        "displayName": {
          "description": "Display name of the role in the requested locale, such as `Author` or `Actor`.",
          "type": "string"
        },
        "value": {
          "description": "Role value for the Amazon catalog item, such as `author` or `actor`.",
          "type": "string"
        }
      },
      "required": [
        "value"
      ],
      "type": "object"
    },
    "ItemDimensions": {
      "description": "An array of dimensions that are associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "items": {
        "$ref": "#/$defs/ItemDimensionsByMarketplace"
      },
      "type": "array"
    },
    "ItemDimensionsByMarketplace": {
      "description": "Dimensions that are associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "item": {
          "description": "Dimensions of an Amazon catalog item.",
          "$ref": "#/$defs/Dimensions"
        },
        "package": {
          "description": "Dimensions of a package that contains an Amazon catalog item.",
          "$ref": "#/$defs/Dimensions"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemDisplayGroupSalesRank": {
      "description": "Sales rank of an Amazon catalog item, grouped by website display group.",
      "properties": {
        "websiteDisplayGroup": {
          "description": "Name of the website display group that is associated with the sales rank",
          "type": "string"
        },
        "title": {
          "description": "Name of the sales rank.",
          "type": "string"
        },
        "link": {
          "description": "Corresponding Amazon retail website URL for the sales rank.",
          "type": "string"
        },
        "rank": {
          "description": "Sales rank.",
          "type": "integer"
        }
      },
      "required": [
        "websiteDisplayGroup",
        "title",
        "rank"
      ],
      "type": "object"
    },
    "ItemIdentifier": {
      "description": "The identifier that is associated with the item in the Amazon catalog, such as a UPC or EAN identifier.",
      "properties": {
        "identifierType": {
          "description": "Type of identifier, such as UPC, EAN, or ISBN.",
          "type": "string"
        },
        "identifier": {
          "description": "Identifier of the item.",
          "type": "string"
        }
      },
      "required": [
        "identifierType",
        "identifier"
      ],
      "type": "object"
    },
    "ItemIdentifiers": {
      "description": "Identifiers associated with the item in the Amazon catalog, such as UPC and EAN identifiers.",
      "items": {
        "$ref": "#/$defs/ItemIdentifiersByMarketplace"
      },
      "type": "array"
    },
    "ItemIdentifiersByMarketplace": {
      "description": "Identifiers that are associated with the item in the Amazon catalog, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).identifier.",
          "type": "string"
        },
        "identifiers": {
          "description": "Identifiers associated with the item in the Amazon catalog for the indicated `marketplaceId`.",
          "items": {
            "$ref": "#/$defs/ItemIdentifier"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "identifiers"
      ],
      "type": "object"
    },
    "ItemImage": {
      "description": "Image for an item in the Amazon catalog.",
      "properties": {
        "variant": {
          "description": "Variant of the image, such as `MAIN` or `PT01`.",
          "type": "string",
          "enum": [
            "MAIN",
            "PT01",
            "PT02",
            "PT03",
            "PT04",
            "PT05",
            "PT06",
            "PT07",
            "PT08",
            "SWCH"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "MAIN",
              "description": "Main image for the item"
            },
            {
              "value": "PT01",
              "description": "Other image #1 for the item"
            },
            {
              "value": "PT02",
              "description": "Other image #2 for the item"
            },
            {
              "value": "PT03",
              "description": "Other image #3 for the item"
            },
            {
              "value": "PT04",
              "description": "Other image #4 for the item"
            },
            {
              "value": "PT05",
              "description": "Other image #5 for the item"
            },
            {
              "value": "PT06",
              "description": "Other image #6 for the item"
            },
            {
              "value": "PT07",
              "description": "Other image #7 for the item"
            },
            {
              "value": "PT08",
              "description": "Other image #8 for the item"
            },
            {
              "value": "SWCH",
              "description": "Swatch image for the item"
            }
          ]
        },
        "link": {
          "description": "URL for the image.",
          "type": "string"
        },
        "height": {
          "description": "Height of the image in pixels.",
          "type": "integer"
        },
        "width": {
          "description": "Width of the image in pixels.",
          "type": "integer"
        }
      },
      "required": [
        "variant",
        "link",
        "height",
        "width"
      ],
      "type": "object"
    },
    "ItemImages": {
      "description": "The images for an item in the Amazon catalog.",
      "items": {
        "$ref": "#/$defs/ItemImagesByMarketplace"
      },
      "type": "array"
    },
    "ItemImagesByMarketplace": {
      "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "images": {
          "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`.",
          "items": {
            "$ref": "#/$defs/ItemImage"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "images"
      ],
      "type": "object"
    },
    "ItemProductTypeByMarketplace": {
      "description": "Product type that is associated with the Amazon catalog item, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "productType": {
          "description": "Name of the product type that is associated with the Amazon catalog item.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ItemProductTypes": {
      "description": "Product types that are associated with the Amazon catalog item.",
      "items": {
        "$ref": "#/$defs/ItemProductTypeByMarketplace"
      },
      "type": "array"
    },
    "ItemRelationship": {
      "description": "Relationship details for an Amazon catalog item.",
      "properties": {
        "childAsins": {
          "description": "ASINs of the related items that are children of this item.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "parentAsins": {
          "description": "ASINs of the related items that are parents of this item.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "variationTheme": {
          "description": "For `VARIATION` relationships, the variation theme indicates the combination of Amazon catalog item attributes that define the variation family.",
          "$ref": "#/$defs/ItemVariationTheme"
        },
        "type": {
          "description": "Type of relationship.",
          "enum": [
            "VARIATION",
            "PACKAGE_HIERARCHY"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "VARIATION",
              "description": "The Amazon catalog item in the request is a variation parent or variation child of the related items that are identified by ASIN."
            },
            {
              "value": "PACKAGE_HIERARCHY",
              "description": "The Amazon catalog item in the request is a package container or is contained by the related items that are identified by ASIN."
            }
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "ItemRelationships": {
      "description": "Relationships grouped by `marketplaceId` for an Amazon catalog item (for example, variations).",
      "items": {
        "$ref": "#/$defs/ItemRelationshipsByMarketplace"
      },
      "type": "array"
    },
    "ItemRelationshipsByMarketplace": {
      "description": "Relationship details for the Amazon catalog item for the specified Amazon `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "relationships": {
          "description": "Relationships for the item.",
          "items": {
            "$ref": "#/$defs/ItemRelationship"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId",
        "relationships"
      ],
      "type": "object"
    },
    "ItemSalesRanks": {
      "description": "Sales ranks of an Amazon catalog item.",
      "items": {
        "$ref": "#/$defs/ItemSalesRanksByMarketplace"
      },
      "type": "array"
    },
    "ItemSalesRanksByMarketplace": {
      "description": "Sales ranks of an Amazon catalog item, grouped by `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "classificationRanks": {
          "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by classification.",
          "items": {
            "$ref": "#/$defs/ItemClassificationSalesRank"
          },
          "type": "array"
        },
        "displayGroupRanks": {
          "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by website display group.",
          "items": {
            "$ref": "#/$defs/ItemDisplayGroupSalesRank"
          },
          "type": "array"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemSummaries": {
      "description": "Summaries of Amazon catalog items.",
      "items": {
        "$ref": "#/$defs/ItemSummaryByMarketplace"
      },
      "type": "array"
    },
    "ItemSummaryByMarketplace": {
      "description": "Information about an Amazon catalog item for the indicated `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "adultProduct": {
          "description": "When `true`, the Amazon catalog item is intended for an adult audience or is sexual in nature.",
          "type": "boolean"
        },
        "autographed": {
          "description": "When `true`, the Amazon catalog item is autographed.",
          "type": "boolean"
        },
        "brand": {
          "description": "Name of the brand that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "browseClassification": {
          "description": "Classification (browse node) that is associated with the Amazon catalog item.",
          "$ref": "#/$defs/ItemBrowseClassification"
        },
        "color": {
          "description": "The color that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "contributors": {
          "description": "Individual contributors to the creation of the item, such as the authors or actors.",
          "items": {
            "$ref": "#/$defs/ItemContributor"
          },
          "type": "array"
        },
        "itemClassification": {
          "description": "Classification type that is associated with the Amazon catalog item.",
          "enum": [
            "BASE_PRODUCT",
            "OTHER",
            "PRODUCT_BUNDLE",
            "VARIATION_PARENT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "BASE_PRODUCT",
              "description": "A product that can be directly purchased. Can be a standalone ASIN or a variation child item in the Amazon catalog."
            },
            {
              "value": "OTHER",
              "description": "An item in the Amazon catalog that is not `BASE_PRODUCT`, `PRODUCT_BUNDLE`, or `VARIATION_PARENT`."
            },
            {
              "value": "PRODUCT_BUNDLE",
              "description": "A parent catalog item that represents a bundle of items."
            },
            {
              "value": "VARIATION_PARENT",
              "description": "A parent catalog item that groups child items into a variation family."
            }
          ],
          "type": "string"
        },
        "itemName": {
          "description": "The name that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "manufacturer": {
          "description": "The name of the manufacturer that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "memorabilia": {
          "description": "When true, the item is classified as memorabilia.",
          "type": "boolean"
        },
        "modelNumber": {
          "description": "The model number that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "packageQuantity": {
          "description": "The quantity of the Amazon catalog item within one package.",
          "type": "integer"
        },
        "partNumber": {
          "description": "The part number that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "releaseDate": {
          "description": "The earliest date on which the Amazon catalog item can be shipped to customers.",
          "format": "date",
          "type": "string"
        },
        "size": {
          "description": "The name of the size of the Amazon catalog item.",
          "type": "string"
        },
        "style": {
          "description": "The name of the style that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "tradeInEligible": {
          "description": "When true, the Amazon catalog item is eligible for trade-in.",
          "type": "boolean"
        },
        "websiteDisplayGroup": {
          "description": "The identifier of the website display group that is associated with the Amazon catalog item.",
          "type": "string"
        },
        "websiteDisplayGroupName": {
          "description": "The display name of the website display group that is associated with the Amazon catalog item.",
          "type": "string"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemVariationTheme": {
      "description": "The variation theme is a list of Amazon catalog item attributes that define the variation family.",
      "properties": {
        "attributes": {
          "description": "Names of the Amazon catalog item attributes that are associated with the variation theme.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "theme": {
          "description": "Variation theme that indicates the combination of Amazon catalog item attributes that define the variation family.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ItemVendorDetails": {
      "description": "The vendor details that are associated with an Amazon catalog item. Vendor details are only available to vendors.",
      "items": {
        "$ref": "#/$defs/ItemVendorDetailsByMarketplace"
      },
      "type": "array"
    },
    "ItemVendorDetailsByMarketplace": {
      "description": "The vendor details that are associated with an Amazon catalog item for the specified `marketplaceId`.",
      "properties": {
        "marketplaceId": {
          "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).",
          "type": "string"
        },
        "brandCode": {
          "description": "The brand code that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "manufacturerCode": {
          "description": "The manufacturer code that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "manufacturerCodeParent": {
          "description": "The parent vendor code of the manufacturer code.",
          "type": "string"
        },
        "productCategory": {
          "description": "The product category that is associated with an Amazon catalog item.",
          "$ref": "#/$defs/ItemVendorDetailsCategory"
        },
        "productGroup": {
          "description": "The product group that is associated with an Amazon catalog item.",
          "type": "string"
        },
        "productSubcategory": {
          "description": "The product subcategory that is associated with an Amazon catalog item.",
          "$ref": "#/$defs/ItemVendorDetailsCategory"
        },
        "replenishmentCategory": {
          "description": "The replenishment category that is associated with an Amazon catalog item.",
          "enum": [
            "ALLOCATED",
            "BASIC_REPLENISHMENT",
            "IN_SEASON",
            "LIMITED_REPLENISHMENT",
            "MANUFACTURER_OUT_OF_STOCK",
            "NEW_PRODUCT",
            "NON_REPLENISHABLE",
            "NON_STOCKUPABLE",
            "OBSOLETE",
            "PLANNED_REPLENISHMENT"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "ALLOCATED",
              "description": "The vendor allocates the inventory to Amazon and Amazon manually purchases it."
            },
            {
              "value": "BASIC_REPLENISHMENT",
              "description": "Inventory is manually purchased."
            },
            {
              "value": "IN_SEASON",
              "description": "Seasonal item that is manually purchased."
            },
            {
              "value": "LIMITED_REPLENISHMENT",
              "description": "Amazon generates orders for this item automatically based on unfilled demand."
            },
            {
              "value": "MANUFACTURER_OUT_OF_STOCK",
              "description": "The vendor is out of stock for an extended period of time and cannot backorder."
            },
            {
              "value": "NEW_PRODUCT",
              "description": "Amazon does not yet stock this item."
            },
            {
              "value": "NON_REPLENISHABLE",
              "description": "Indicates assortment parent used for detail page display, not actual items."
            },
            {
              "value": "NON_STOCKUPABLE",
              "description": "Drop ship inventory that Amazon does not stock in its fulfillment centers."
            },
            {
              "value": "OBSOLETE",
              "description": "The item is obsolete and should not be ordered."
            },
            {
              "value": "PLANNED_REPLENISHMENT",
              "description": "Active items that should be automatically ordered."
            }
          ],
          "type": "string"
        }
      },
      "required": [
        "marketplaceId"
      ],
      "type": "object"
    },
    "ItemVendorDetailsCategory": {
      "description": "The product category or subcategory that is associated with an Amazon catalog item.",
      "properties": {
        "displayName": {
          "description": "The display name of the product category or subcategory.",
          "type": "string"
        },
        "value": {
          "description": "The code that identifies the product category or subcategory.",
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}