Inventory Endpoints

Get Inventory List

Retrieve current inventory data with stock levels, velocity metrics, and restock information.

GET /inventory/list

Query Parameters:

Parameter	Type	Required	Description
per_page	integer	Yes	Results per page. Allowed: 20, 50, 100, 250, 500, 1000, 2000
velocity_start_date	string	No	Start date for velocity calculation (Y-m-d)
velocity_end_date	string	No	End date for velocity calculation (Y-m-d)
page	integer	No	Page number for pagination

Plus an account selection parameter.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/inventory/list?account_title=My Store US&per_page=100&velocity_start_date=2025-01-01&velocity_end_date=2025-01-31" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

{
  "current_page": 1,
  "total": 47,
  "per_page": 100,
  "last_page": 1,
  "data": [
    {
      "sku": "MY-SKU-001",
      "product_name": "My Product Name",
      "asin": "B0XXXXXXXXX",
      "fnsku": "X0XXXXXXXXX",
      "afn_fulfillable_quantity": 150,
      "afn_inbound_working_quantity": 0,
      "afn_inbound_shipped_quantity": 50,
      "afn_reserved_quantity": 10,
      "afn_unsellable_quantity": 2,
      "velocity": 5.2,
      "days_of_stock": 29,
      "restock_suggestion": 100
    }
  ]
}

Response Fields:

Field	Type	Description
sku	string	Seller SKU
product_name	string	Product title
asin	string	Amazon ASIN
fnsku	string	Fulfillment Network SKU
afn_fulfillable_quantity	integer	Units available for sale in FBA
afn_inbound_working_quantity	integer	Units in inbound shipments being prepared
afn_inbound_shipped_quantity	integer	Units in inbound shipments in transit
afn_reserved_quantity	integer	Units reserved (customer orders, transfers)
afn_unsellable_quantity	integer	Units marked as unsellable
velocity	number	Sales velocity (units/day) for the specified date range
days_of_stock	integer	Estimated days of stock remaining based on velocity
restock_suggestion	integer	Suggested restock quantity

Python SDK:

from sellerlegend_api import SellerLegendClient

client = SellerLegendClient(access_token="YOUR_ACCESS_TOKEN")

inventory = client.inventory.list(
    account_title="My Store US",
    per_page=500,
    velocity_start_date="2024-01-01",
    velocity_end_date="2024-01-31"
)

for item in inventory['data']:
    print(f"SKU: {item['sku']}")
    print(f"Fulfillable: {item['afn_fulfillable_quantity']}")
    print(f"Days of Stock: {item['days_of_stock']}")

TIP

Use velocity_start_date and velocity_end_date to control the date range used for calculating sales velocity and days-of-stock estimates. A longer range gives a more stable average, while a shorter range reflects recent trends.