Supply Chain Endpoints

Get Restock Suggestions

Retrieve automated restock suggestions based on current stock levels, sales velocity, and lead times.

GET /supply-chain/restock-suggestions

Query Parameters:

Parameter	Type	Required	Description
per_page	integer	Yes	Results per page. Allowed: 500, 1000, 2000
currency	string	No	Currency for values (e.g., USD)
page	integer	No	Page number for pagination

Plus an account selection parameter.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/supply-chain/restock-suggestions?account_title=My Store US&per_page=500&currency=USD" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

{
  "current_page": 1,
  "total": 23,
  "per_page": 500,
  "last_page": 1,
  "data": [
    {
      "sku": "MY-SKU-001",
      "product_name": "My Product Name",
      "current_stock": 45,
      "days_of_stock": 12,
      "velocity_30_days": 3.8,
      "suggested_quantity": 200,
      "restock_by_date": "2025-02-10",
      "lead_time_days": 21,
      "supplier": "Supplier ABC"
    }
  ]
}

Response Fields:

Field	Type	Description
sku	string	Seller SKU
product_name	string	Product title
current_stock	integer	Current fulfillable stock in FBA
days_of_stock	integer	Estimated days of stock remaining
velocity_30_days	number	Average daily sales over the last 30 days
suggested_quantity	integer	Recommended restock quantity
restock_by_date	string	Date by which you should restock (Y-m-d)
lead_time_days	integer	Supplier lead time in days
supplier	string	Supplier name

Python SDK:

from sellerlegend_api import SellerLegendClient

client = SellerLegendClient(access_token="YOUR_ACCESS_TOKEN")

suggestions = client.supply_chain.get_restock_suggestions(
    account_title="My Store US",
    per_page=500,
    currency="USD"
)

for item in suggestions['data']:
    print(f"SKU: {item['sku']}")
    print(f"Suggested Qty: {item['suggested_quantity']}")
    print(f"Restock By: {item['restock_by_date']}")

TIP

Products with low days_of_stock relative to lead_time_days need urgent attention to avoid stockouts.