StockSnapshot v2 - Open-API

This endpoint allows you to retrieve the inventory quantities for specified SKUs across different regional warehouses, categorized by their various statuses.
Enhancements from v1:
Supports pagination, enabling you to return the complete set of SKUs.
Parameters:
SKUList: At least one SKU must be provided in this parameter.
Response:
The response includes inventory data for the following regional warehouses:

AU (Sydney warehouse)

AU-MEL (Melbourne warehouse)

US-East

UE-South

US-West
For a complete list of available services, we recommend using the getServiceList API.

该 Snapshot v2接口支持获取各个SKU在各个区域仓内的、不同状态的库存数量。
接口对比 v1，支持分页查询，可以返回全量的 SKU 。
入参中， SKUList 中至少有一个入参必填。
返回的区域仓包括：UK,DE,AU(澳洲的悉尼仓),AU-MEL(澳洲的墨尔本仓),US-East,UE-South,US-West 等，建议您通过"getServiceList" API获取最新数据

Request

Header Params

Body Params application/json

Example

{
  "data": {
    "pageNumber": 1,
    "pageSize": 200,
    "skuList": [],
    "serviceRegionList": [
      {
        "serviceRegion": "DE"
      }
    ]
  },
  "messageId": "1d217396-2565-4c87-a009-19c96dbb616f",
  "timestamp": "1701315629000"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Examples

SuccessException

{
    "code": 0,
    "data": {
        "SKUList": [
            {
                "MFSKUID": "OC0000012208036",
                "available": 0,
                "inTransit": 441,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 40,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012214015",
                "available": 0,
                "inTransit": 707,
                "received": 4,
                "reservedAllocated": 0,
                "reservedHold": 0,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012214042",
                "available": 0,
                "inTransit": 0,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 0,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012214079",
                "available": 0,
                "inTransit": 0,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 0,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012220012",
                "available": 0,
                "inTransit": 681,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 20,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012220021",
                "available": 0,
                "inTransit": 771,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 15,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012220030",
                "available": 0,
                "inTransit": 0,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 6,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012222018",
                "available": 0,
                "inTransit": 0,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 5,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012230066",
                "available": 0,
                "inTransit": 624,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 0,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012230075",
                "available": 0,
                "inTransit": 0,
                "received": 28533,
                "reservedAllocated": 0,
                "reservedHold": 7100,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012252015",
                "available": 0,
                "inTransit": 793,
                "received": 0,
                "reservedAllocated": 0,
                "reservedHold": 20,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012254011",
                "available": 0,
                "inTransit": 54,
                "received": 1003,
                "reservedAllocated": 0,
                "reservedHold": 20,
                "reservedVAS": 0,
                "serviceRegion": "DE",
                "suspend": 0,
                "unfulfillable": 0
            },
            {
                "MFSKUID": "OC0000012252024",
                "available": 0,
                "inTransit": 0,
                "received": 100,

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found