---
title: "List company-level location settings"
method: POST
path: "/api/warehouse/location/level/list"
tags: ["Warehouse"]
---

# List company-level location settings

`POST /api/warehouse/location/level/list`

## Request

- Base URL: `https://api.desty.app`
- URL: `https://api.desty.app/api/warehouse/location/level/list`
- Auth: none declared. Required headers: `Authorization`

## Description

List company-level location configuration.

## Response example

``` json
{
  "code": "0",
  "msg": null,
  "data": [
    {
      "level": 7,
      "name": "Bin",
      "description": "Stock storage",
      "storingPreference": "STORAGE"
    }
  ],
  "success": true
}
```

## Errors

Check `code`, not only HTTP status. Invalid parameters, authentication and rate-limit errors normally use HTTP 200 with `INVALID_PARAMETER`, `INVALID_TOKEN` or `LIMIT_REQUEST`. Server/downstream errors use HTTP 500 with `SERVER_ERROR`.

## Headers

- `Authorization` string, required

## Request body

- object

## Response `200`

successful operation

- object
  - `code` string, required: Business result code: "0" on success; otherwise INVALID_PARAMETER, INVALID_TOKEN, LIMIT_REQUEST or SERVER_ERROR.
  - `msg` string, nullable: Result message; normally null on success.
  - `data` object[], nullable: Company-level location configuration.
    - `level` integer, required: Location level number (1–7); not a storage level record ID.
    - `name` string, required: Company-configured name of the level.
    - `description` string, required: Company-configured description.
    - `storingPreference` 'STORAGE' | 'ORGANIZATIONAL', required: Whether locations at this level can store stock. Level 7 is returned as STORAGE.
  - `success` boolean, required: True when code equals "0".

## Changes

- **2026-11-06** `4946760fb77d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/changes/api/warehouse/location/level/list/post.md)

---

[API](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26.md) - [All operations](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/llms.txt) - [OpenAPI document](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/revisions/4946760fb77d?raw)