Skip to main content
GET
List Locations
There is no GET /api/v1/locations.json endpoint, and the OAuth App API exposes no location/warehouse listing. Inventory locations are read only through the merchant dashboard surface documented below, which is authenticated with a merchant session (JWT) — not with an OAuth app access token. Installed apps cannot list locations.

List Locations

Inventory locations are modeled as warehouses. List them through the merchant endpoint GET /warehouse/get-all-warehouses. Authentication: merchant session, allowed roles MERCHANT, STAFF_ADMIN, SUPER_ADMIN, MANAGER, STAFF.

Response

The warehouses for the store are returned as an array under data, each with its associated inventory rows. When the store has no warehouses, the endpoint returns a 404 with state: "info" and message Warehouses for this store not found.