---
title: "Search warehouses"
method: POST
path: "/v3/shipping-costs/search-warehouse"
tags: ["Shipping"]
---

# Search warehouses

`POST /v3/shipping-costs/search-warehouse`

## Request

- Base URL: `https://api.scalev.com`
- URL: `https://api.scalev.com/v3/shipping-costs/search-warehouse`
- Auth: one of:
  - HTTP bearer
  - API key in header `authorization`

Requires the `order:create` scope. Search for warehouses based on order details, store, destination, and product variants.

## Request body

- SearchWarehouseRequest: Schema for searching warehouses
  - `destination_id` integer, required: ID of the destination location
  - `order_id` union: Canonical UUIDv7 order primary key. For migrated orders, legacy numeric `core_order.id` values are still accepted as numbers or decimal strings.
    - string
    - integer
  - `store_id` integer, required: ID of the store
  - `variants` object[], required: List of product variant ids and their quantities
    - `qty` integer, required: Quantity of the product variant
    - `variant_id` integer, required: ID of the product variant

## Response `200`

Warehouses list

- SearchWarehousesResponseBody: Non-paginated list payload for v3.
  - `data` SearchWarehouseResult[], required
    - `destination` Location
      - `id` integer, required: Location ID
      - `subdistrict_name` string, required: Subdistrict name
      - `city_name` string, required: City name
      - `province_name` string, required: Province name
      - `kelurahan_name` string, nullable, required: Kelurahan name
      - `display` string, required: Display name
    - `distance_km` number, float: Distance in kilometers
    - `warehouse` object
      - `business` object
        - `id` integer: Business ID
        - `username` string: Username of the business
      - `id` integer: Warehouse ID
      - `lincah_origin_id` string: Lincah origin ID for the warehouse
      - `mengantar_origin_id` string: Mengantar origin ID for the warehouse
      - `name` string: Name of the warehouse
      - `unique_id` string: Unique identifier of the warehouse
      - `warehouse_address` object
        - `address` string: Full address of the warehouse
        - `city` string: City of the warehouse address
        - `id` integer: Warehouse Address ID
        - `kelurahan` string, nullable: Kelurahan of the warehouse address
        - `location` integer: Location ID for the address
        - `postal_code` string: Postal code of the warehouse address
        - `province` string: Province of the warehouse address
        - `subdistrict` string: Subdistrict of the warehouse address
    - `warehouse_partner` object
      - `id` integer: Warehouse Partner ID
      - `ka_origin_id` string: KA Origin ID
      - `lincah_origin_id` string: Lincah Origin ID
      - `mengantar_origin_id` string: Mengantar Origin ID
      - `partner_id` integer: Partner Business ID
  - `is_paginated` false, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-22** `b4add50bab84`: 2 info
  - added the optional property `data/items/warehouse/warehouse_address/kelurahan` to the response with the `200` status
  - added the required property `data/items/destination/kelurahan_name` to the response with the `200` status

[Operation history](https://skmtc.dev/scalev/apis/nexus-commerce-api/changes/v3/shipping-costs/search-warehouse/post.md)

---

[API](https://skmtc.dev/scalev/apis/nexus-commerce-api.md) - [All operations](https://skmtc.dev/scalev/apis/nexus-commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalev/apis/nexus-commerce-api/revisions/6b9152f04622?raw)