2026-07-15 Changelog

• Catalog API

  • Vendor information (Beta): CatalogItemVariation.vendor_information now exposes default unit cost, vendor, and vendor code per item variation.

• Inventory API

  • Track costs and vendors (Beta): Record cost_money and vendor_id on stock-receiving adjustments, and edit past adjustments (quantity, cost_money, vendor_id, reason_id) with the new UpdateInventoryAdjustment endpoint. Writing cost and vendor data requires an active Retail Plus, Restaurants Plus, or Restaurants Premium subscription.

• Adjustment reasons (Beta): Categorize adjustments with standard and seller-defined custom reasons via a reason_id on InventoryAdjustment and the new /v2/inventory/adjustment-reasons endpoints (list, retrieve, create, update, delete, restore). Filter change history by reason_ids.
• Sortable change history (Beta): BatchRetrieveInventoryChanges now accepts a sort field to order results by occurred_at.
• Updated adjustment model: Cross-location movement is now represented as an ADJUSTMENT with from_location_id and to_location_id. The TRANSFER change type, InventoryTransfer object, RetrieveInventoryTransfer endpoint, and InventoryAdjustment.location_id are retired as of 2026-07-15. The UNTRACKED state and Square-generated inferred and component adjustments are now exposed in responses.

• Orders API
  • New IN_STORE fulfillment type for orders that a buyer receives at the seller's location at the time of sale. Access to write IN_STORE fulfillments is limited to partners enrolled in the closed Beta; To request access, reach out to your Square Partner Manager or submit a partnership request.

New documentation:

• Inventory Adjustment Reasons
• Track Inventory Costs and Vendors
• Manage Vendor Information on Item Variations

Learn about versioning for the Square API and SDKs.