Get inventory Expired percent

GET

/api/v1/products/{{oasin}}/warehouses/{{warehouse_code}}/stocks/expired-percent

Description

This API returns all available inventory records of a product along with their expiry dates, manufacturing dates, remaining shelf-life percentages, and available stock quantities.

This information can be used when creating shipments with product_strategy = EXPIRED_PERCENT.

Path Parameters

Parameter	Type	Required	Description
oasin	string	Yes	Unique product OASIN identifier.
warehouse_code	string	Yes	Warehouse code.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/api/v1/products/{{oasin}}/warehouses/{{warehouse_code}}/stocks/expired-percent' \
--header 'Authorization: <api-key>'

Response Example

{
    "data": [
        {
            "expiry_date": "2027-03-28",
            "expiry_date_percent": 88.0,
            "expiry_date_timestamp": 1806166800.0,
            "manufacturing_date": "2026-04-01",
            "availability_stock": 50
        },
        {
            "expiry_date": "2027-01-26",
            "expiry_date_percent": 72.0,
            "expiry_date_timestamp": 1800896400.0,
            "manufacturing_date": "2026-02-01",
            "availability_stock": 50
        }
    ],
    "error": false,
    "error_code": null,
    "log_id": null,
    "messages": "OK",
    "total": 1,
    "version": "1.0.3"
}

Modified at 2026-06-02 09:51:05

Get inventory Expired date

Updated Shipment Status

Get inventory Expired percent

Description#

Path Parameters#

Request

Responses

Description

Path Parameters