UNFI Product

Schema representing a product in the UNFI wholesale food distribution catalog.

Food DistributionWholesaleNatural FoodsSupply ChainFortune 500

Properties

Name	Type	Description
productId	string	UNFI product identifier
upc	string	Universal Product Code (12 digits)
gtin	string	Global Trade Item Number (GS1 GDSN 14 digits)
name	string	Product name
brand	string	Brand name
description	string	Product description
category	string	Primary product category (e.g., Snacks, Beverages, Frozen Foods)
subCategory	string	Product subcategory
certifications	array	Product certifications
unitSize	string	Unit size (e.g., 7 oz, 1 lb)
unitsPerCase	integer	Number of units per case
retailPrice	number	Suggested retail price in USD
status	string	Product availability status

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/united-natural-foods/main/json-schema/unfi-supplier-product-schema.json",
  "title": "UNFI Product",
  "description": "Schema representing a product in the UNFI wholesale food distribution catalog.",
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "UNFI product identifier",
      "examples": ["UNFI-0012345"]
    },
    "upc": {
      "type": "string",
      "description": "Universal Product Code (12 digits)",
      "pattern": "^[0-9]{12}$"
    },
    "gtin": {
      "type": "string",
      "description": "Global Trade Item Number (GS1 GDSN 14 digits)",
      "pattern": "^[0-9]{14}$"
    },
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "brand": {
      "type": "string",
      "description": "Brand name"
    },
    "description": {
      "type": "string",
      "description": "Product description"
    },
    "category": {
      "type": "string",
      "description": "Primary product category (e.g., Snacks, Beverages, Frozen Foods)"
    },
    "subCategory": {
      "type": "string",
      "description": "Product subcategory"
    },
    "certifications": {
      "type": "array",
      "description": "Product certifications",
      "items": {
        "type": "string",
        "enum": ["organic", "non-gmo", "kosher", "gluten-free", "vegan", "fair-trade"]
      },
      "uniqueItems": true
    },
    "unitSize": {
      "type": "string",
      "description": "Unit size (e.g., 7 oz, 1 lb)",
      "examples": ["7 oz"]
    },
    "unitsPerCase": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of units per case"
    },
    "retailPrice": {
      "type": "number",
      "format": "double",
      "minimum": 0,
      "description": "Suggested retail price in USD"
    },
    "status": {
      "type": "string",
      "enum": ["active", "discontinued", "seasonal"],
      "description": "Product availability status"
    }
  },
  "required": ["upc", "name", "brand", "category", "status"]
}