1. APIs
Help for ShipSage
  • 中文版 V2.0
    • 接口集成
      • OMS API
        • 入门指南
        • 接口
          • 店铺
          • 仓库
          • 产品
          • 库存
          • 订单
          • 包裹
          • 物流跟踪
          • 发货计划
          • 转运
          • 增值服务
          • 退货
          • 文件上传
  • English V2.0
    • API Integration
      • OMS API
        • Getting Started
        • APIs
          • Account
          • Warehouse
          • Product
          • Inventory
          • Order
          • Shipping
          • Tracking
          • ASN
          • Transfer
          • VAS
          • Return
          • File Upload
  1. APIs

Warehouse

Endpoints#

MethodEndpointDescription
GET/api/v202206/warehousesRetrieve warehouse list
[NEW] v202608 Patch (2026-09):
Existing GET /api/v202206/warehouses response now includes a new shipping_services field (list of shipping channels enabled at the warehouse).
Existing GET /api/v202206/warehouses query params now support carrier and carrier_service (filter by carrier / service name).
The additions below are new in this patch.

Header#

KeyValue
AuthorizationBearer eyJ0eXAiOiJKV1QiLCJhbGciOi ...

GET /api/v202206/warehouses (Retrieve warehouse list)#

Request#

Params#
TypeNameDescriptionRequired/OptionalSchema
queryapiThe API type

Available Values:
index.by-default
requiredenum
Request Example#
GET /api/v202206/warehouses?api=index.by-default

Response#

KeyValue
errcode0/4000
errmsgok/Error Info
dataData Properties
Data Properties#
NameDescriptionSchema
warehouse_idThe warehouse idinteger
warehouse_nameThe warehouse namestring
address1The street address (line 1)string
address2The street address (line 2)string
countryThe countrystring
stateThe state / provincestring
zipThe zip codestring
cityThe citystring
phoneThe contact numberstring
faxThe contact faxstring
shipping_services[NEW] v202608
Array of shipping channels currently enabled at this warehouse (empty array if none enabled)
array
[NEW] v202608 shipping_services sub-structure#
NameDescriptionSchema
carrierCarrier name
Examples: FedEx / UPS / USPS / DHL
string
carrier_serviceCarrier service name
Examples: FedEx Ground / FedEx Ground Home Delivery / UPS Next Day Air
string
Response Example#
{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "items": [
            {
                "warehouse_id": 100,
                "warehouse_name": "SG-MDW1",
                "address1": "460 Gibraltar Drive",
                "address2": null,
                "state": "IL",
                "zip": "60440",
                "city": "Bolingbrook",
                "phone": "888-566-8826",
                "fax": "8885081917",
                "country": "US",
                "shipping_services": [
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground" },
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground Home Delivery" },
                    { "carrier": "UPS",   "carrier_service": "UPS Next Day Air" }
                ]
            },
            {
                "warehouse_id": 101,
                "warehouse_name": "SG-SMF1",
                "address1": "2900 N MacArthur Dr Suite 150",
                "address2": null,
                "state": "CA",
                "zip": "95376",
                "city": "Tracy",
                "phone": "888-566-8826",
                "fax": "8885081917",
                "country": "US",
                "shipping_services": [
                    { "carrier": "FedEx", "carrier_service": "FedEx Ground" }
                ]
            },
            {
                "warehouse_id": 103,
                "warehouse_name": "SG-MEM1",
                "address1": "8835 Commerce Dr Suite 103",
                "address2": null,
                "state": "MS",
                "zip": "38671",
                "city": "Southaven",
                "phone": "888-566-8826",
                "fax": "6625366226",
                "country": "US",
                "shipping_services": []
            },
            {
                "warehouse_id": 109,
                "warehouse_name": "SG-ABE1",
                "address1": "7185 Ambassador Dr",
                "address2": null,
                "state": "PA",
                "zip": "18106",
                "city": "Allentown",
                "phone": "888-566-8826",
                "fax": "8885081917",
                "country": "US",
                "shipping_services": []
            },
            {
                "warehouse_id": 112,
                "warehouse_name": "SG-ATL1",
                "address1": "495 Horizon Dr. suite 300",
                "address2": "",
                "state": "GA",
                "zip": "30024",
                "city": "Suwanee",
                "phone": "888-566-8826",
                "fax": "",
                "country": "US",
                "shipping_services": []
            },
            {
                "warehouse_id": 117,
                "warehouse_name": "SG-ONT3",
                "address1": "11310 Harrel St Dock1",
                "address2": "",
                "state": "CA",
                "zip": "91752",
                "city": "Jurupa Valley",
                "phone": "888-566-8826",
                "fax": "",
                "country": "US",
                "shipping_services": []
            }
        ]
    }
}
Modified at 2026-09-23 06:55:28
Previous
Account
Next
Product
Built with