About the Stores Locations API

The Stores Locations API is a read-only API that provides access to inventory locations for Wix Stores. This API exists to simplify querying locations relevant to Stores inventory, without needing to filter through all business locations.

To create or update locations, use the Wix Locations API. All changes are reflected in this API. Only locations with INVENTORY in the locationTypes array appear in this API.

With the Stores Locations API, you can:

• Query locations configured for Stores inventory.
• Retrieve location details for use with the Inventory Items API.
• Identify the default location for a store.

Creating inventory locations

To create a new inventory location:

1. Call Create Location in the Wix Locations API.
2. Include "INVENTORY" in the locationTypes array.

The location then automatically appears in the Stores Locations API.

Default location

When a store is created, a default location is automatically created. This default location is used for inventory items that don't have a specific location assigned.

When customers place orders on a Wix Store, inventory automatically deducts from the default location. If you need to deduct stock from specific non-default locations, you can't use Wix's standard checkout functionality. This applies to multi-location inventory scenarios, offline purchases, and POS transactions.

For more details on how inventory deduction works, see Online Store Product Purchase Flow.

Before you begin

It's important to note the following points before starting to code:

• The Wix user must install the Wix Stores app.

Use cases

• Create a new inventory location
• Retrieve inventory locations for a store

Terminology

For a comprehensive glossary of Catalog V3 terms, see Terminology.