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

# Search warehouses

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

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

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/4354959d76dc/schema)