---
title: "Query Storage Locations"
method: GET
path: "/v2/warehouses/{warehouseId}/storagelocations"
tags: ["warehouse"]
---

# Query Storage Locations

`GET /v2/warehouses/{warehouseId}/storagelocations`

## Request

- Base URL: `https://scx-sbx.api.jtl-software.com`
- URL: `https://scx-sbx.api.jtl-software.com/v2/warehouses/{warehouseId}/storagelocations`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.jtl-cloud.com/oauth2/auth`
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `warehouse.read`
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.jtl-cloud.com/oauth2/token` scopes: `warehouse.read`
- TypeScript: <https://skmtc.dev/jtl-software/apis/scx-authentication-api/docs/v2/warehouses/:warehouseId/storagelocations/get.ts> (a function with typed inputs; its response is checked against the schema)

Query all storage locations for a given warehouse

## Path parameters

- `warehouseId` string, uuid, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Response `200`

Returns all storage locations of the warehouse.

- JTLWawiRestContractsModelsPagedListOfJTLWawiRestContractsModelsV1WarehouseStorageLocation: Represents a paginated list of items
  - `totalItems` integer: Gets or sets the total number of items available in the data source.
  - `pageNumber` integer: Gets or sets the current page number in the paginated list.
  - `pageSize` integer: Gets or sets the number of items per page in the paginated list.
  - `items` JTLWawiRestContractsModelsV1WarehouseStorageLocation[]: Gets or sets the collection of items contained in the paged list.
    - `id` string, uuid
    - `warehouseId` string, uuid
    - `name` string: Name of the storage bin. This identifies the exact location inside the warehouse.
    - `storageLocationType` JTLWawiRestContractsModelsV1WarehouseStorageLocationType: Model Class: StorageLocationType
      - `id` string: Unique Id of the storage location type as UUID.
      - `name` string: Name of the storage location type.
      - `description` string: Description of the storage location type.
      - `scope` string[]: List of Scopes with permissions
    - `sortNumber` integer: Sort number for the storage location. Used for creating picking lists.
    - `priority` integer: Priority of the storage location.
    - `lockForShipment` boolean: Declares if the warehouse is locked for shipment.
    - `lockForAvailability` boolean: Declares is the warehouse is locked for stock availabilites.
    - `comment` string: Comment for the storage bin.
    - `dimensions` JTLWawiRestContractsModelsV1CommonDimensions: Model Class: Dimensions
      - `length` number: Length
      - `width` number: Width
      - `height` number: Height
  - `totalPages` integer: Gets the total number of pages based on the total number of items and the page size.
  - `hasPreviousPage` boolean: Gets a value indicating whether there is a previous page available in the paginated list.
  - `hasNextPage` boolean: Gets a value indicating whether there is a next page available.
  - `nextPageNumber` integer: Gets the number of the next page if there is one; otherwise, returns the total number of pages.
  - `previousPageNumber` integer: Gets the number of the previous page. If there is no previous page, it returns 1.

## Other responses

- `401`
- `402`: No licence available or the app has not been authorised by JTL.
- `404`: No warehouse with the given ID exists.

---

[API](https://skmtc.dev/jtl-software/apis/scx-authentication-api.md) - [All operations](https://skmtc.dev/jtl-software/apis/scx-authentication-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jtl-software/apis/scx-authentication-api/revisions/f979b1ea6951?raw)