> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Locations

> List inventory locations (warehouses)

<Warning>
  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.
</Warning>

# 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.`

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": "Warehouses retrieved successfully",
    "data": [
      {
        "warehouseId": "5e6f7a8b-9c0d-1e2f-3a4b-5c6d7e8f9a0b",
        "warehouseName": "Main Warehouse",
        "warehouseType": "Primary",
        "contactPerson": "Jane Roe",
        "mobileNumber": "+15551234567",
        "address": "123 Commerce St, Suite 100",
        "area": "Downtown",
        "city": "Los Angeles",
        "state": "California",
        "pinCode": "90001",
        "localPickupEnabled": true,
        "pickupHours": "Mon-Sat 10am-7pm",
        "storeId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "inventories": [],
        "createdAt": "2024-01-01T00:00:00Z",
        "updatedAt": "2024-01-01T00:00:00Z"
      }
    ],
    "count": null,
    "pagination": null
  }
  ```
</ResponseExample>