> For the complete documentation index, see [llms.txt](https://docs.kakaclo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kakaclo.com/admin-api/api-reference/stock.md).

# Stock

{% hint style="info" %}
This interface is to query sku inventory. The same sku may belong to different repositories.
{% endhint %}

## Request parameter

<table><thead><tr><th width="250.33333333333331">Parameter name</th><th>Type</th><th>Remark</th></tr></thead><tbody><tr><td>skus</td><td>String</td><td>Commodity SKU code collections, specify the commodity SKU code query, each time a maximum of <strong>30</strong>, Three options are required. for example: <strong>FSZW03961_Y_S_NUB,FSZW03961_Y_XL_NUB</strong></td></tr><tr><td>warehouseCode</td><td>String</td><td>warehouse code. for example: <strong>G007</strong></td></tr><tr><td>dateStartTime</td><td>String</td><td>Inventory update start time, one of the three is required. for example: <strong>2022-03-25T04:00:30Z</strong></td></tr><tr><td>dateEndTime</td><td>String</td><td>Inventory update end time, one of the three is required. for example: <strong>2022-03-26T04:00:30Z</strong></td></tr><tr><td>pageNumber</td><td>Number</td><td>Page number, when querying according to the update time, PageNumber is required and greater than 0. for example: 1</td></tr></tbody></table>

<details>

<summary>When querying according to skus, sku is required, and other parameters are optional, for example:</summary>

[https://developer.kakaclo.com/openapi/v1/product/stocks?skus=FSZW03961\_Y\_S\_NUB](https://test-developer.kakaclo.com/openapi/v1/product/stocks?skus=FSZW03961_Y_S_NUB)

</details>

<details>

<summary>When querying based on the update time, either dateStartTime and dateEndTime are required, pageNumber is required, and other parameters are optional, for example:</summary>

[https://developer.kakaclo.com/openapi/v1/product/stocks?dateStartTime=2022-08-01T00:00:00Z\&pageNumber=1\&dateEndTime=2022-08-02T00:00:00Z](https://test-developer.kakaclo.com/openapi/v1/product/stocks?dateStartTime=2022-08-01T00:00:00Z\&pageNumber=1\&dateEndTime=2022-08-02T00:00:00Z)

</details>

## Response parameter

| Parameter name | Type   | Remark                                                                                               |
| -------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| sku            | String | product unique code, for example: FSZW03961\_Y\_S\_NUB                                               |
| qty            | Number | Inventory quantity, for example: 20                                                                  |
| countryCode    | String | Country code of the country where the warehouse is located, for example: CN\_S                       |
| warehouseCode  | String | warehouse code, for example: G007                                                                    |
| total          | Number | The total number of query results(The total number of list data for paging query), for example: 1000 |
| pageNumber     | Number | page number, for example: 1                                                                          |
| pageSize       | Number | Quantity per page, for example: 30                                                                   |

{% hint style="info" %}

#### The countryCode and warehouseCode fields are reserved fields, and developers do not need to pay attention to the use of these two fields.

{% endhint %}

#### Response Example

```
{
    "code": 10000,
    "data": {
        "total": 1,
        "pageNumber": 1,
        "pageSize": 30,
        "list": [
            {
                "warehouseStockList": [
                    {
                        "countryCode": "CN_N",
                        "qty": 45,
                        "warehouseCode": "G006"
                    },
                    {
                        "countryCode": "CN_S",
                        "qty": 20,
                        "warehouseCode": "G007"
                    }
                ],
                "sku": "FSZW03961_Y_XL_NUB"
            }
        ]
    },
    "message": "Success！"
}
```

## Query stock

## get product stock

<mark style="color:blue;">`GET`</mark> `/openapi/v1/product/stocks`

#### Query Parameters

| Name                                            | Type   | Description                                                                                                                                                                                                        |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| skus<mark style="color:red;">\*</mark>          | String | <p>Commodity SKU code collections, specify the commodity SKU code query, each time a maximum of 30, Three options are required. for example:</p><p><strong>FSZW03961\_Y\_S\_NUB,FSZW03961\_Y\_XL\_NUB</strong></p> |
| warehouseCode                                   | String | warehouse code. for example: G007                                                                                                                                                                                  |
| dateStartTime<mark style="color:red;">\*</mark> | String | Inventory update start time, one of the three is required. for example: 2022-03-25T04:00:30Z                                                                                                                       |
| dateEndTime<mark style="color:red;">\*</mark>   | String | Inventory update end time, one of the three is required. for example: 2022-03-26T04:00:30Z                                                                                                                         |
| pageNumber                                      | Number | Page number, when querying according to the update time, PageNumber is required and greater than 0. for example: 1                                                                                                 |

{% tabs %}
{% tab title="200: OK Successfully query" %}

```json
{
    "code": 10000,
    "data": {
        "total": 2,
        "pageNumber": 1,
        "pageSize": 30,
        "list": [
            {
                "warehouseStockList": [
                    {
                        "countryCode": "CN_N",
                        "qty": 45,
                        "warehouseCode": "G006"
                    },
                    {
                        "countryCode": "CN_S",
                        "qty": 20,
                        "warehouseCode": "G007"
                    }
                ],
                "sku": "FSZW03961_Y_S_NUB"
            },
            {
                "warehouseStockList": [
                    {
                        "countryCode": "CN_N",
                        "qty": 45,
                        "warehouseCode": "G006"
                    },
                    {
                        "countryCode": "CN_S",
                        "qty": 20,
                        "warehouseCode": "G007"
                    }
                ],
                "sku": "FSZW03961_Y_XL_NUB"
            }
        ]
    },
    "message": "Success！"
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}