United Natural Foods (UNFI)

United Natural Foods, Inc. (UNFI) is the largest publicly traded wholesale distributor of health and specialty food in the United States and Canada. UNFI supplies natural, organic, specialty, and conventional foods to over 30,000 retail locations. UNFI provides digital supplier and customer portals including myUNFI, supplier portal, EDI integration, and the Harmony Core API for data access.

2 APIs 0 Features

Food DistributionWholesaleNatural FoodsSupply ChainFortune 500

APIs

UNFI Harmony Core API

UNFI's Harmony Core API provides read-only access to 42 data files covering supplier, product, inventory, and sales data across UNFI's distribution network. Consumers can perfor...

UNFI EDI Integration

UNFI supports Electronic Data Interchange (EDI) for automated exchanges of purchase orders, invoices, and fulfillment data between UNFI and its supplier and retail partners. EDI...

Collections

UNFI Supplier and Data API

OPEN

Pricing Plans

United Natural Foods Plans Pricing

1 plans

PLANS

Rate Limits

United Natural Foods Rate Limits

1 limits

RATE LIMITS

FinOps

United Natural Foods Finops

FINOPS

Semantic Vocabularies

United Natural Foods Context

0 classes · 28 properties

JSON-LD

API Governance Rules

United Natural Foods (UNFI) API Rules

15 rules · 4 errors 9 warnings 2 info

SPECTRAL

JSON Structure

Unfi Supplier Product Structure

0 properties

JSON STRUCTURE

Example Payloads

Unfi Supplier Getsalesinsights Example

2 fields

EXAMPLE

Unfi Supplier Listorders Example

2 fields

EXAMPLE

Unfi Supplier Listproducts Example

2 fields

EXAMPLE

Press

UNFI taps into AI to improve forecasting, fulfillment

2026-05-25

AI is starting to take over inventory planning and it's ...

2026-05-25

United Natural Foods Expands Supply Chain Evolution ...

2026-05-25

United Natural Foods announces partnership with ...

2026-05-25

UNFI and Symbotic Announce Agreement to Implement ...

2026-05-25

Resources

Supplier Portal

Supplier Portal

Customer Portal

Customer Portal

Investor Relations

Investor Relations

SpectralRules

JSONLDContext

Sources

opencollection: 1.0.0
info:
  name: UNFI Supplier and Data API
  version: 1.0.0
items:
- info:
    name: Products
    type: folder
  items:
  - info:
      name: List Products
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/products
      params:
      - name: category
        value: ''
        type: query
        description: Product category filter
      - name: brand
        value: ''
        type: query
        description: Brand name filter
      - name: certification
        value: ''
        type: query
        description: Filter by product certification
      - name: page
        value: ''
        type: query
        description: Page number for pagination
      - name: pageSize
        value: ''
        type: query
        description: Number of results per page
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve a paginated list of products in the UNFI catalog. Supports filtering by category, brand, and certification
      type.
  - info:
      name: Create Product
      type: http
    http:
      method: POST
      url: https://api.unfi.com/v1/products
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Submit a new product listing to the UNFI catalog via the supplier portal.
  - info:
      name: Get Product
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/products/:productId
      params:
      - name: productId
        value: ''
        type: path
        description: UNFI product identifier
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve details for a specific product by its UNFI product ID.
  - info:
      name: Update Product
      type: http
    http:
      method: PUT
      url: https://api.unfi.com/v1/products/:productId
      params:
      - name: productId
        value: ''
        type: path
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Update an existing product listing in the UNFI catalog.
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: List Orders
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/orders
      params:
      - name: status
        value: ''
        type: query
        description: Filter by order status
      - name: startDate
        value: ''
        type: query
        description: Start date filter
      - name: endDate
        value: ''
        type: query
        description: End date filter
      - name: warehouseId
        value: ''
        type: query
        description: Filter by UNFI warehouse
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve purchase orders for the supplier or retailer account.
  - info:
      name: Get Order
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/orders/:orderId
      params:
      - name: orderId
        value: ''
        type: path
        description: Purchase order identifier
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve details for a specific purchase order.
  - info:
      name: Submit Order Fulfillment
      type: http
    http:
      method: POST
      url: https://api.unfi.com/v1/orders/:orderId/fulfillment
      params:
      - name: orderId
        value: ''
        type: path
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Submit fulfillment information for a purchase order including ship date and tracking.
- info:
    name: Insights
    type: folder
  items:
  - info:
      name: Get Sales Insights
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/insights/sales
      params:
      - name: startDate
        value: ''
        type: query
        description: Start date for insights query
      - name: endDate
        value: ''
        type: query
        description: End date for insights query
      - name: granularity
        value: ''
        type: query
        description: Data aggregation granularity
      - name: region
        value: ''
        type: query
        description: Distribution region filter
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve sales analytics data from the UNFI Insights dashboard. Provides comprehensive sales, inventory, and deduction
      data across UNFI's entire network spanning both natural (west) and conventional (east) distribution channels.
  - info:
      name: Get Fill Rate Data
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/insights/fill-rates
      params:
      - name: startDate
        value: ''
        type: query
      - name: endDate
        value: ''
        type: query
      - name: productId
        value: ''
        type: query
        description: Filter by specific product
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve fill rate metrics for supplier products across UNFI distribution centers.
  - info:
      name: Get Inventory Insights
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/insights/inventory
      params:
      - name: warehouseId
        value: ''
        type: query
        description: Filter by specific UNFI warehouse
      - name: asOf
        value: ''
        type: query
        description: Inventory snapshot date
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve inventory levels, voids, and food waste dashboard data.
- info:
    name: Suppliers
    type: folder
  items:
  - info:
      name: Get Supplier Profile
      type: http
    http:
      method: GET
      url: https://api.unfi.com/v1/suppliers/:supplierId
      params:
      - name: supplierId
        value: ''
        type: path
        description: UNFI supplier identifier
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Retrieve supplier profile including contact and warehouse information.
  - info:
      name: Update Supplier Profile
      type: http
    http:
      method: PUT
      url: https://api.unfi.com/v1/suppliers/:supplierId
      params:
      - name: supplierId
        value: ''
        type: path
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: X-API-Key
        value: '{{X-API-Key}}'
        placement: header
    docs: Update supplier contact, warehouse, and broker information.
bundled: true