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

Shipping

Endpoints#

MethodEndpointDescription
GET/api/v202105/shippingsRetrieves a list of shippings

Header#

KeyValue
AuthorizationBearer eyJ0eXAiOiJKV1QiLCJhbGciOi ...

GET /api/v202105/shippings#

Request#

Params#
TypeNameDescriptionRequired/OptionalSchema
queryapiThe API type

Available Values:
index.by-default
requiredenum
querynext_tokenThe next page dataoptionalstring
querytrx_idShipsage Transaction IDoptionalstring
queryplatform_order_idPlatform Order Numberoptionalstring
querycustomer_order_idCustomer Order Numberoptionalstring
queryaccount_idSales Account IDoptionalinteger
queryaccount_nameSales Account Nameoptionalstring
querycreate_time_startCreate Time Start timezone:PSToptionaldatetime
querycreate_time_endCreate Time End timezone:PSToptionaldatetime
queryupdate_time_startUpdate Time Start timezone:PSToptionaldatetime
queryupdate_time_endUpdate Time End timezone:PSToptionaldatetime

Response#

KeyValue
errcode0/4000
errmsgok/Error Info
dataData Properties
Data Properties#
NameDescription
shipping_idThe shipsage shipping idinteger
carrierThe transport companystring
service_type_nameThe carrier service type namestring
warehouse_nameThe warehouse namestring
tracking_numberThe tracking numberstring
is_reshipWhether reship

Available Values:
0:not reship, 1:reship
enum
lengthThe box length (inch)double
widthThe box width (inch)double
heightThe box height (inch)double
weight_lbThe box weight in poundsinteger
weight_ozThe box weight in ouncesinteger
ship_to_nameThe recipient's namestring
ship_to_address1The recipient's address onestring
ship_to_address2The recipient's address twostring
ship_to_phoneThe recipient's phonestring
ship_to_cityThe recipient's address citystring
ship_to_stateThe recipient's address statestring
ship_to_countryThe recipient's address countrystring
ship_to_postal_codeThe recipient's address postal codestring
statusThe shipping status

Available Values:
CREATED, PICKED, PACKED, FINAL SCANNED,UNFULFILLABLE,VOIDED,PENDING,SYNCED
enum
final_scan_timeThe warehouse final scan time timezone:PSTdatetime
shipping_fee _estimatedThe estimated shipping feedouble
shipping_feeThe shipping feedouble
handling_feeThe handling feedouble
packing_material_feeThe packing material feedouble
create_timeThe shipping create time timezone:PSTdatetime
update_timeThe shipping update time timezone:PSTdatetime
detail_itemsShipping detail itemsarray
detail_items.*.shipping_idThe shipsage shipping idinteger
detail_items.*.trx_idThe shipsage order numberstring
detail_items.*.platform_order_idThe platform order numberstring
detail_items.*.customer_order_idThe customer order numberstring
detail_items.*.account_idThe sales account idstring
detail_items.*.account_nameThe sales account namestring
detail_items.*.product_idThe shipsage product idinteger
detail_items.*.skuThe shipsage skuinteger
detail_items.*.customer_skuThe customer skustring
detail_items.*.product_nameThe product namestring
detail_items.*.qtyThe shipping qtyinteger
Data Demo#
[
    {
        "shipping_id": 5639864,
        "carrier": "UPS",
        "service_type_name": "UPS Ground",
        "warehouse_id": 101,
        "warehouse_name": "Tracy",
        "tracking_number": "1Z3Y4R930398123456",
        "is_reship": 0,
        "length": 46,
        "width": 18,
        "height": 5,
        "weight": 14300,
        "weight_lb": 31,
        "weight_oz": 8.4,
        "ship_to_name": "Elijah Sanchez",
        "ship_to_address1": "2117 KENTUCKY ST",
        "ship_to_address2": null,
        "ship_to_phone": "16026716610",
        "ship_to_city": "BAKERSFIELD",
        "ship_to_state": "CA",
        "ship_to_country": "US",
        "ship_to_postal_code": "93305",
        "status": "CREATED",
        "create_time": "2022-03-06 02:05:03",
        "update_time": "2022-03-06 02:05:03",
        "detail_items": [
            {
                "shipping_id": 5639864,
                "trx_id": "SS10-PON-001",
                "platform_order_id": "PON-001",
                "customer_order_id": "CON-001",
                "account_id": 123,
                "account_name": "TestAccount01",
                "product_id": 111864,
                "sku": 209582,
                "customer_sku": "209582",
                "product_name": "1 Set Matte Black Metal Clothing Rack V2S_Racks,Shelves&Drawers",
                "qty": 1
            }
        ]
    },
    {
        "shipping_id": 5639863,
        "carrier": "UPS",
        "service_type_name": "UPS Sure Post",
        "warehouse_id": 103,
        "warehouse_name": "Southaven",
        "tracking_number": "1Z3Y4R930398123457",
        "is_reship": 0,
        "length": 13,
        "width": 10,
        "height": 2,
        "weight": 1300,
        "weight_lb": 2,
        "weight_oz": 13.9,
        "ship_to_name": "Elijah Sanchez",
        "ship_to_address1": "2117 KENTUCKY ST",
        "ship_to_address2": null,
        "ship_to_phone": "16026716610",
        "ship_to_city": "BAKERSFIELD",
        "ship_to_state": "CA",
        "ship_to_country": "US",
        "ship_to_postal_code": "93305",
        "status": "CREATED",
        "create_time": "2022-03-06 02:05:03",
        "update_time": "2022-03-06 02:05:03",
        "detail_items": [
            {
                "shipping_id": 5639863,
                "trx_id": "SS10-PON-001",
                "platform_order_id": "PON-001",
                "customer_order_id": "CON-001",
                "account_id": 123,
                "account_name": "TestAccount01",
                "product_id": 111804,
                "sku": 209522,
                "customer_sku": "209522",
                "product_name": "46\"x17.3\"x68.9\" Blue Cover with box for V2S,V7,V30_Racks,Shelves&Drawers",
                "qty": 1
            }
        ]
    }
]
Modified at 2026-08-13 00:43:51
Previous
Order
Next
Tracking
Built with