Fulfillment locations

Read-only catalog of HioBuy Fulfillment Locations for self-purchase flows (where to ship domestic parcels in China).

Availability: Sandbox is MOCK. Warehouse-mode live keys forward to POST /api/gateway-worker/v1/warehouse.

Requires warehouse fulfillment. Scope: warehouse:read.

List Fulfillment Locations

Returns available HioBuy Fulfillment locations, receiving addresses, supported destination countries, supported services, business hours and current receiving status.

Receiving addresses are returned in the local Chinese format and should be used as provided when placing orders with Chinese suppliers or marketplaces.

Query parameters

No pagination. Empty match → 200 with data: [].

Typical call:

GET /v1/fulfillment/locations?destination_country=KR&receiving_status=OPEN

Sort: recommended first, then OPEN receiving, then id.

Status fields

Holiday pause: keep status=ACTIVE, set receiving_status=PAUSED, fill notice.

IDs and country

The warehouse has no location CODE. Live Public id is the warehouse numeric id as a string (e.g. "1"). country is the warehouse Chinese name (e.g. 中国), not CN.

Sandbox mock only: loc_wh_001 (Weihai · KR/JP) · loc_sz_001 (Shenzhen · US/CA/AU, paused) · loc_yw_001 (Yiwu · EU).

Live example

{
  "data": [
    {
      "id": "1",
      "name": "默认仓库",
      "country": "中国",
      "province": "",
      "city": "",
      "address": {
        "recipient": "小海鸥",
        "phone": "18866886688",
        "postal_code": "430000",
        "address_line": "深圳龙岗区"
      },
      "supported_destinations": [
        "US",
        "ID"
      ],
      "recommended": true,
      "status": "ACTIVE",
      "receiving_status": "OPEN",
      "notice": "默认演示仓库地址",
      "updated_at": "2026-04-22T13:49:32.000Z"
    }
  ],
  "request_id": "req_..."
}

Related

• Inbound notice
• Fulfillment overview
• Internal: locations.md